Re: [PATCH v2 1/3] doc: provide guidance on user.name format

2019-10-17 Thread Jeff King
On Thu, Oct 17, 2019 at 10:20:38PM +, brian m. carlson wrote: > > > Documentation/git-commit-tree.txt | 6 ++ > > > 1 file changed, 6 insertions(+) > > > > ...I was surprised to see it here, where I think most users wouldn't > > find it. Would it make sense in git-commit(1), or in the de

Re: [PATCH v2 1/3] doc: provide guidance on user.name format

2019-10-17 Thread brian m. carlson
On 2019-10-17 at 05:40:52, Jeff King wrote: > On Thu, Oct 17, 2019 at 12:53:28AM +, brian m. carlson wrote: > > > It's a frequent misconception that the user.name variable controls > > authentication in some way, and as a result, beginning users frequently > > attempt to change it when they're

Re: [PATCH v2 1/3] doc: provide guidance on user.name format

2019-10-17 Thread Junio C Hamano
Jeff King writes: > I think this is a good distinction to draw, but... > >> Documentation/git-commit-tree.txt | 6 ++ >> 1 file changed, 6 insertions(+) > > ...I was surprised to see it here, where I think most users wouldn't > find it. Would it make sense in git-commit(1), or in the descrip

Re: [PATCH v2 1/3] doc: provide guidance on user.name format

2019-10-16 Thread Jeff King
On Thu, Oct 17, 2019 at 12:53:28AM +, brian m. carlson wrote: > It's a frequent misconception that the user.name variable controls > authentication in some way, and as a result, beginning users frequently > attempt to change it when they're having authentication troubles. > Document that the c

[PATCH v2 1/3] doc: provide guidance on user.name format

2019-10-16 Thread brian m. carlson
It's a frequent misconception that the user.name variable controls authentication in some way, and as a result, beginning users frequently attempt to change it when they're having authentication troubles. Document that the convention is that this variable represents some form of a human's personal