From: Junio C Hamano Date: Fri, 11 Mar 2011 08:09:34 GMT Subject: Re: [PATCH 2/2] Add Author and Documentation sections to git-for-each-ref.txt Message-ID: <7vwrk6yt6p.fsf@alter.siamese.dyndns.org> In-Reply-To: <20110311062041.GA20048@sigill.intra.peff.net> Jeff King writes: > On Thu, Mar 10, 2011 at 03:09:43PM -0800, Junio C Hamano wrote: > >> > Yeah, I would just as soon drop Author and Documented-by fields in all >> > manpages. We could replace them with a single "Credits" in git(1). It >> > can either mention nobody, very few people (like Linus as the originator >> > and Junio as the long-time maintainer), or the top N (for N < 20 or so) >> > people in shortlog. And then mention that you can run shortlog yourself. >> >> Sounds sensible. > > If you want to see what the full patch would look like, you can fetch it > from: > > git://github.com/peff/git.git jk/doc-credits > > The patch itself is rather large, so I didn't want to post it. Thanks; will immediately queue to 'pu' for wider dissemination. I think the changes are all sensible. The credits are there in the shortlog, and the contributors' names are displayed at one of the more prominent git related sites, namely http://git-scm.com/about/, to honor them, so I don't think keeping already stale information on each and every manpage is warranted.