Re: [PATCH v3] doc: tweak "man gitcli" for clarity

2017-11-24 Thread Robert P. J. Day
On Fri, 24 Nov 2017, Junio C Hamano wrote: > "Robert P. J. Day" writes: > > > -This manual describes the convention used throughout Git CLI. > > +This manual describes the conventions used throughout Git CLI. > > OK. > > > Many commands take revisions (most often

Re: [PATCH v3] doc: tweak "man gitcli" for clarity

2017-11-23 Thread Junio C Hamano
Junio C Hamano writes: >> - * Without disambiguating `--`, Git makes a reasonable guess, but errors >> - out and asking you to disambiguate when ambiguous. E.g. if you have a >> - file called HEAD in your work tree, `git diff HEAD` is ambiguous, and >> + * In cases where

Re: [PATCH v3] doc: tweak "man gitcli" for clarity

2017-11-23 Thread Junio C Hamano
"Robert P. J. Day" writes: > -This manual describes the convention used throughout Git CLI. > +This manual describes the conventions used throughout Git CLI. OK. > Many commands take revisions (most often "commits", but sometimes > "tree-ish", depending on the context