From: Nicolas Pitre <nico@cam.org>
Date: Sun, 10 Dec 2006 22:07:40 GMT
Subject: Re: [PATCH] Documentation/git-commit: rewrite to make it more end-user friendly.
Message-ID: <Pine.LNX.4.64.0612101704390.2630@xanadu.home>
In-Reply-To: <20061210210057.GB23387@fieldses.org>

On Sun, 10 Dec 2006, J. Bruce Fields wrote:

> Or maybe: "by using gitlink:git-add[1] to add new content (of either new
> or newly modified files) to the next commit."
> 
> Man pages are reference documentation, so I figure it's OK to sacrifice
> a little newbie-friendliness for accuracy and concision.

I disagree.  Clarity should be the first goal.  And the fact that even 
modified files have to be specified is something worth enphasizing, 
especially since this is not something other systems do.