Re: [PATCH] doc: provide guidance on user.name format

> "brian m. carlson" <sandals@crustytoothpaste.net> writes:
> > diff --git a/Documentation/git-commit-tree.txt b/Documentation/git-commit-tree.txt
> > index 4b90b9c12a..34a8496b0e 100644
> > --- a/Documentation/git-commit-tree.txt
> > +++ b/Documentation/git-commit-tree.txt
> > @@ -92,6 +92,12 @@ if set:
> >  
> >  (nb "<", ">" and "\n"s are stripped)
> >  
> > +The author and committer names are by convention some form of a personal name,
> > +as opposed to a username, although Git does not enforce or require any
> > +particular form.
> 
> I have a lot of trouble with 'username' in the context of this
> paragraph.
> 
> After all, you are describing the name appropriate to be set as the
> value of the user.name configuration, and you are trying to stress
> that the name used there is different from and has nothing to do
> with the name machines use to identify the user.  In the paragraph
> that follows this new paragraph, there is a reference to "system
> user name", which is still not great but probably better than
> "username" above.  Perhaps there is a term that is distinct enough
> from "user name" that is commonly used I am forgetting?  I am almost
> tempted to say "user id", but there must be even better phrases.  I
> dunno.