Re: Can't figure out some sense from the git-commit-tree man page

On Fri, Aug 17, 2007 at 01:04:11PM -0400, J. Bruce Fields [off-list ref] wrote:

On Fri, Aug 17, 2007 at 05:52:52PM +0100, Johannes Schindelin wrote:

quoted

Hi,

On Fri, 17 Aug 2007, Mike Hommey wrote:

quoted

  ?   committer name and email and the commit time.
  If not provided, "git-commit-tree" uses your name, hostname and domain to
  provide author and committer info. This can be overridden by either
  .git/config file, or using the following environment variables.
  (...)

The "If not provided" part doesn't make sense.

It does, if you know how to specify the committer info.

Which the man page specifies how to provide:

At least on a first reading all of the following appears to fall under
the "if not provided" case.  I know what you mean, but the language here
is misleading.  One simple fix would be just to delete the words "If not
provided", or maybe replace them by "By default, ...".

I think it would be better to put the fact that "If not provided..."
*after* telling that you can provide author, committer, etc. by setting
environment or editing the conf.

Mike