From owner-cvs-all@FreeBSD.ORG Wed Aug 12 12:05:13 2009 Return-Path: Delivered-To: cvs-all@FreeBSD.org Received: by hub.freebsd.org (Postfix, from userid 1033) id 0E9F9106572B; Wed, 12 Aug 2009 12:05:13 +0000 (UTC) Date: Wed, 12 Aug 2009 12:05:12 +0000 From: Alexey Dokuchaev To: Doug Barton Message-ID: <20090812120512.GA38933@FreeBSD.org> References: <200908102241.n7AMfN09004919@repoman.freebsd.org> <4A80B9BE.4020408@FreeBSD.org> <20090811043217.GA6076@FreeBSD.org> <4A81AA27.8040908@FreeBSD.org> Mime-Version: 1.0 Content-Type: text/plain; charset=koi8-r Content-Disposition: inline In-Reply-To: <4A81AA27.8040908@FreeBSD.org> User-Agent: Mutt/1.4.2.1i Cc: cvs-ports@FreeBSD.org, cvs-all@FreeBSD.org, ports-committers@FreeBSD.org Subject: Re: cvs commit: ports UPDATING X-BeenThere: cvs-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: **OBSOLETE** CVS commit messages for the entire tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 12 Aug 2009 12:05:24 -0000 On Tue, Aug 11, 2009 at 10:28:07AM -0700, Doug Barton wrote: > Alexey Dokuchaev wrote: > > Well, it's really hard to add anything here. :-) > > "Update line breaks, punctuation, and white space on the recent KDE4 > and libtool entries to improve readability." > > I'm picking on a trivial case here, so sorry Alexey, but from what I > can see the trend is getting worse, not better. > > There are 3 main rules for log entries: > 1. Keep in mind that people will be reading this years from now when > you are long gone. > 2. A brief summary of WHAT was done makes browsing the logs and > finding specific entries easier. However if necessary that can always > be discovered with diff, so > 3. Always err on the side of including more information about WHY a > change was made. Fair enough. Thanks for being pedantic, I like it. :-) ./danfe