From owner-cvs-all Tue Apr 25 6:32: 8 2000 Delivered-To: cvs-all@freebsd.org Received: from mailgate.originative.co.uk (mailgate.originative.co.uk [194.217.50.228]) by hub.freebsd.org (Postfix) with ESMTP id 73ED737B6C8; Tue, 25 Apr 2000 06:32:02 -0700 (PDT) (envelope-from paul@originative.co.uk) Received: from originative.co.uk (lobster.originative.co.uk [194.217.50.241]) by mailgate.originative.co.uk (Postfix) with ESMTP id 992A71D15F; Tue, 25 Apr 2000 14:32:00 +0100 (BST) Message-ID: <39059E50.78E0B20D@originative.co.uk> Date: Tue, 25 Apr 2000 14:32:00 +0100 From: Paul Richards Organization: Originative Solutions Ltd X-Mailer: Mozilla 4.72 [en] (X11; I; Linux 2.2.12 i386) X-Accept-Language: en-GB, en MIME-Version: 1.0 To: Alexander Langer Cc: Nik Clayton , cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: doc/en_US.ISO_8859-1/books/porter-handbook book.sgml References: <200004222335.QAA55709@freefall.freebsd.org> <390586B7.C49BAAA2@originative.co.uk> <20000425141439.B7779@cichlids.cichlids.com> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG Alexander Langer wrote: > > Thus spake Paul Richards (paul@originative.co.uk): > > > be done in a separate email, not placed for all time into the commit > > logs. > > Hmm. I seriously wonder why: Usual translaters grab the cvslog/diffs > of the English versions and merge these into the translations. > > So it's obvious that the commitmessage is a good point to document, > what one does one have to do to change. > > What are the reasons against this? The commit log is supposed to show the reason for the change, so that when someone is later looking at the differences between the two revisions they can gain an understanding of why the change was made. It is not supposed to be a copy of what the change is, since that can be found using cvs diff, and it is not supposed to be documentation relating to what to do about the diff. The reason for the latter is that a) it clogs up the diffs when you are trying to see *why* changes were made b) if you later want to find that documentation the cvs logs are likely to be one of the last places you will look. I have long thought that it would be a good idea to add another tag to the commit message that separates what the committer wants to put in the logs, and what they would like to have sent to the list since I know that it is all too tempting to just compile an email message there and then, rather than fuss with sending a separate message to the list. Shouldn't be too hard to do in our Perl scripts, just send all the text before the tag into cvs, and include the rest in the mail message sent out. Paul. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message