From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.emacs.gnus.general/26719 Path: main.gmane.org!not-for-mail From: Denys Duchier Newsgroups: gmane.emacs.gnus.general Subject: Re: *** empty log message *** is a no-no Date: 12 Nov 1999 13:00:50 +0100 Sender: owner-ding@hpc.uh.edu Message-ID: References: NNTP-Posting-Host: coloc-standby.netfonds.no Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: main.gmane.org 1035163875 20912 80.91.224.250 (21 Oct 2002 01:31:15 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Mon, 21 Oct 2002 01:31:15 +0000 (UTC) Return-Path: Original-Received: from bart.math.uh.edu (bart.math.uh.edu [129.7.128.48]) by sclp3.sclp.com (8.8.5/8.8.5) with ESMTP id HAA01418 for ; Fri, 12 Nov 1999 07:01:24 -0500 (EST) Original-Received: from sina.hpc.uh.edu (lists@Sina.HPC.UH.EDU [129.7.3.5]) by bart.math.uh.edu (8.9.1/8.9.1) with ESMTP id GAB24681; Fri, 12 Nov 1999 06:01:21 -0600 (CST) Original-Received: by sina.hpc.uh.edu (TLB v0.09a (1.20 tibbs 1996/10/09 22:03:07)); Fri, 12 Nov 1999 06:01:39 -0600 (CST) Original-Received: from sclp3.sclp.com (root@sclp3.sclp.com [204.252.123.139]) by sina.hpc.uh.edu (8.9.3/8.9.3) with ESMTP id GAA18609 for ; Fri, 12 Nov 1999 06:01:24 -0600 (CST) Original-Received: from uni-sb.de (uni-sb.de [134.96.252.33]) by sclp3.sclp.com (8.8.5/8.8.5) with ESMTP id HAA01413 for ; Fri, 12 Nov 1999 07:00:54 -0500 (EST) Original-Received: from cs.uni-sb.de (cs.uni-sb.de [134.96.252.31]) by uni-sb.de (8.9.3/1999070600) with ESMTP id NAA04983 for ; Fri, 12 Nov 1999 13:00:51 +0100 (CET) Original-Received: from talo.ps.uni-sb.de (talo.ps.uni-sb.de [134.96.186.116]) by cs.uni-sb.de (8.9.3/1999031900) with ESMTP id NAA26832 for ; Fri, 12 Nov 1999 13:00:50 +0100 (CET) Original-Received: (from duchier@localhost) by talo.ps.uni-sb.de (8.9.1a/8.9.1) id NAA21149; Fri, 12 Nov 1999 13:00:50 +0100 Original-To: ding@gnus.org In-Reply-To: Steinar Bang's message of "12 Nov 1999 11:57:55 +0100" Original-Lines: 28 User-Agent: Gnus/5.070098 (Pterodactyl Gnus v0.98) Emacs/20.4 Precedence: list X-Majordomo: 1.94.jlt7 Xref: main.gmane.org gmane.emacs.gnus.general:26719 X-Report-Spam: http://spam.gmane.org/gmane.emacs.gnus.general:26719 Steinar Bang writes: > My experience with CVS (and RCS) tells me that this is a no-no. > > The most important thing you get from these versioning systems is IMO > the human readable log of changes. If you have access to the > commitlog you can search for keywords and find out when changes were > made. I absolutely concur. I was about to suggest the very same thing. Personally, when I implement something new, I usually include full documentation in the log message. This way (1) others reading the logs are well informed about what I have done, (2) when I get around to writing actual documentation, I already have an outline of it in the logs. When fixing a tricky bug, it is also a good idea to document your understanding of it. My view is that the CVS logs serve the dual purpose of keeping everyone informed about on-going progress in the project as well as of being a persistent repository of useful information/documentation. Cheers, -- Dr. Denys Duchier Denys.Duchier@ps.uni-sb.de Forschungsbereich Programmiersysteme (Programming Systems Lab) Universitaet des Saarlandes, Geb. 45 http://www.ps.uni-sb.de/~duchier Postfach 15 11 50 Phone: +49 681 302 5618 66041 Saarbruecken, Germany Fax: +49 681 302 5615