From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Deniz Dogan Newsgroups: gmane.emacs.help Subject: Re: Changelogs, really useful? Date: Fri, 6 Aug 2010 19:37:08 +0200 Message-ID: References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 X-Trace: dough.gmane.org 1281116308 18582 80.91.229.12 (6 Aug 2010 17:38:28 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 6 Aug 2010 17:38:28 +0000 (UTC) Cc: help-gnu-emacs@gnu.org To: Andrea Crotti Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Fri Aug 06 19:38:27 2010 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1OhQsE-000149-Sr for geh-help-gnu-emacs@m.gmane.org; Fri, 06 Aug 2010 19:38:27 +0200 Original-Received: from localhost ([127.0.0.1]:43475 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OhQry-0002jy-Ga for geh-help-gnu-emacs@m.gmane.org; Fri, 06 Aug 2010 13:38:10 -0400 Original-Received: from [140.186.70.92] (port=39333 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OhQrY-0002jt-BV for help-gnu-emacs@gnu.org; Fri, 06 Aug 2010 13:37:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OhQrW-000873-NE for help-gnu-emacs@gnu.org; Fri, 06 Aug 2010 13:37:44 -0400 Original-Received: from mail-vw0-f41.google.com ([209.85.212.41]:62593) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OhQrW-00086x-GT for help-gnu-emacs@gnu.org; Fri, 06 Aug 2010 13:37:42 -0400 Original-Received: by vws16 with SMTP id 16so7377157vws.0 for ; Fri, 06 Aug 2010 10:37:41 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:mime-version:received:in-reply-to :references:from:date:message-id:subject:to:cc:content-type; bh=od55JCjEAm0XxQe/VzrjcYbQEW3Z98pwq0V1l97CmME=; b=qRljLFbdKuOfFC8hNb0Wx6jDXMuAaesxwsah43FKW/dJcanV9BkWY9JQyMr52T5cbf 2Q3m0k9YLbK45Gb1211pg+M/azso3NEN1b8LmLCwRDHb4dBVdAegl7pLYJQuCYZft3Hp 1FXQtbQITEysAqe36tP8SJsegDF+ttdqa4UO4= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; b=pMLFBcQk0hYvUZuVhSAXu2eFwPE86v49LO1NXd3I2EvGsQtj+7uato/ygXCs3ru9ZW eUhTNQrIwxfFmU4Y2RFDI+DA3OqMJFhiiEBLXIuKSP08Jm85YoKAjLq38b4UB9GUcq7V vHnZhJ/pWSJN6zxDHj00JpqMZTWdTsJEc7B/o= Original-Received: by 10.220.75.200 with SMTP id z8mr8512371vcj.197.1281116258268; Fri, 06 Aug 2010 10:37:38 -0700 (PDT) Original-Received: by 10.220.188.77 with HTTP; Fri, 6 Aug 2010 10:37:08 -0700 (PDT) In-Reply-To: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:74484 Archived-At: 2010/8/6 Andrea Crotti : > It's not really a question about emacs maybe (even if we can automate > things) but more general about programming... > > I was wondering if it's still so useful to write detailed Changelogs. > I mean all the software is under revision control, and doing small > commits often I write a commit message for only one function, which > would be exactly what I add in the changelog. > > I don't like to write things twice, and also history in the control > revision system is much more detailed, does it really make sense to add > changelogs? > > I think that only the changes that involve the architecture or how to > use the software should be really important, but the default style on > emacs is quite detailed. > > How do you manage? > Write twice? Write only in the changelog/scm? Other? > > Thanks > I suspect it's nice to have a changelog as a file just to be able to put it online or wherever people would find it useful. Not everyone enjoys or knows how to see the bzr log. Also, consider that the changelog file was introduced before bzr, which meant that without it people would have to look in a CVS log. (Those poor people!) -- Deniz Dogan