[PATCH] Documentation/diff-options: explain different diff algorithms

2018-08-10 Thread Stefan Beller
As a user I wondered what the diff algorithms are about. Offer at least a basic explanation on the differences of the diff algorithms. Signed-off-by: Stefan Beller --- Not sure if this is finished, I just want to put out the state that I have sitting on my disk. Documentation/diff-options.tx

Re: [PATCH] Documentation/diff-options: explain different diff algorithms

2018-08-09 Thread Stefan Beller
On Mon, Aug 6, 2018 at 4:18 PM Jonathan Nieder wrote: > > +DIFF ALGORITHMS > > +--- > > Please add some introductory words about what the headings refer to. ok. > > > +the shortest output. > > Trivia: the `minimal` variant of Myers doesn't guarantee shortest > output, either: what i

Re: [PATCH] Documentation/diff-options: explain different diff algorithms

2018-08-09 Thread Stefan Beller
On Tue, Aug 7, 2018 at 8:56 AM Junio C Hamano wrote: > > Jonathan Nieder writes: > > > Both don't seem quite right, since they have an extra space before the > > period. The git-diff(1) seems especially not quite right --- does it > > intend to say something like "See the DIFF ALGORITHMS section

Re: [PATCH] Documentation/diff-options: explain different diff algorithms

2018-08-07 Thread Junio C Hamano
Jonathan Nieder writes: > Both don't seem quite right, since they have an extra space before the > period. The git-diff(1) seems especially not quite right --- does it > intend to say something like "See the DIFF ALGORITHMS section for more > discussion"? Good suggestion and doing so would nice

Re: [PATCH] Documentation/diff-options: explain different diff algorithms

2018-08-06 Thread Jonathan Nieder
Hi, Stefan Beller wrote: > --- a/Documentation/diff-options.txt > +++ b/Documentation/diff-options.txt > @@ -91,14 +91,18 @@ appearing as a deletion or addition in the output. It > uses the "patience > diff" algorithm internally. > > --diff-algorithm={patience|minimal|histogram|myers}:: > -

[PATCH] Documentation/diff-options: explain different diff algorithms

2018-08-06 Thread Stefan Beller
As a user I wondered what the diff algorithms are about. Offer at least a basic explanation on the differences of the diff algorithms. Signed-off-by: Stefan Beller --- Documentation/diff-options.txt | 10 +++--- Documentation/git-diff.txt | 34 ++ 2 files

Re: [PATCH] Documentation/diff-options: explain different diff algorithms

2018-07-24 Thread Junio C Hamano
Stefan Beller writes: > On Mon, Jul 23, 2018 at 9:41 PM Jonathan Nieder wrote: >> >> Hi, >> >> Stefan Beller wrote: >> >> > As a user I wondered what the diff algorithms are about. Offer at least >> > a basic explanation on the differences of the diff algorithms. >> >> Interesting. Let's see. >

Re: [PATCH] Documentation/diff-options: explain different diff algorithms

2018-07-24 Thread Stefan Beller
On Mon, Jul 23, 2018 at 9:41 PM Jonathan Nieder wrote: > > Hi, > > Stefan Beller wrote: > > > As a user I wondered what the diff algorithms are about. Offer at least > > a basic explanation on the differences of the diff algorithms. > > Interesting. Let's see. > > [...] > > --- a/Documentation/di

Re: [PATCH] Documentation/diff-options: explain different diff algorithms

2018-07-23 Thread Jonathan Nieder
Hi, Stefan Beller wrote: > As a user I wondered what the diff algorithms are about. Offer at least > a basic explanation on the differences of the diff algorithms. Interesting. Let's see. [...] > --- a/Documentation/diff-options.txt > +++ b/Documentation/diff-options.txt > @@ -94,16 +94,34 @@

[PATCH] Documentation/diff-options: explain different diff algorithms

2018-07-23 Thread Stefan Beller
As a user I wondered what the diff algorithms are about. Offer at least a basic explanation on the differences of the diff algorithms. Signed-off-by: Stefan Beller --- Documentation/diff-options.txt | 32 +--- 1 file changed, 25 insertions(+), 7 deletions(-) diff --g