From owner-cvs-ports@FreeBSD.ORG Tue Aug 11 17:28:18 2009 Return-Path: Delivered-To: cvs-ports@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 86E581065686 for ; Tue, 11 Aug 2009 17:28:18 +0000 (UTC) (envelope-from dougb@FreeBSD.org) Received: from mail2.fluidhosting.com (mx21.fluidhosting.com [204.14.89.4]) by mx1.freebsd.org (Postfix) with ESMTP id 18CE88FC21 for ; Tue, 11 Aug 2009 17:28:17 +0000 (UTC) Received: (qmail 28839 invoked by uid 399); 11 Aug 2009 17:28:14 -0000 Received: from localhost (HELO foreign.dougb.net) (dougb@dougbarton.us@127.0.0.1) by localhost with ESMTPAM; 11 Aug 2009 17:28:14 -0000 X-Originating-IP: 127.0.0.1 X-Sender: dougb@dougbarton.us Message-ID: <4A81AA27.8040908@FreeBSD.org> Date: Tue, 11 Aug 2009 10:28:07 -0700 From: Doug Barton Organization: http://www.FreeBSD.org/ User-Agent: Thunderbird 2.0.0.22 (X11/20090729) MIME-Version: 1.0 To: Alexey Dokuchaev References: <200908102241.n7AMfN09004919@repoman.freebsd.org> <4A80B9BE.4020408@FreeBSD.org> <20090811043217.GA6076@FreeBSD.org> In-Reply-To: <20090811043217.GA6076@FreeBSD.org> X-Enigmail-Version: 0.95.7 OpenPGP: id=D5B2F0FB Content-Type: text/plain; charset=KOI8-R Content-Transfer-Encoding: 7bit Cc: cvs-ports@FreeBSD.org, cvs-all@FreeBSD.org, ports-committers@FreeBSD.org Subject: Re: cvs commit: ports UPDATING X-BeenThere: cvs-ports@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the ports tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 11 Aug 2009 17:28:19 -0000 Alexey Dokuchaev wrote: > On Mon, Aug 10, 2009 at 05:22:22PM -0700, Doug Barton wrote: >> Alexey Dokuchaev wrote: >>> danfe 2009-08-10 22:41:23 UTC >>> >>> FreeBSD ports repository >>> >>> Modified files: >>> . UPDATING >>> Log: >>> Beautify. >> Can we get a little more detail in the log messages please? :) I'm >> all for brevity being the soul of wit and all that .... > > 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. Once again, this is a trivial case, but practice makes perfect ... Doug -- This .signature sanitized for your protection