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 20:17:05 +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 1281118692 27365 80.91.229.12 (6 Aug 2010 18:18:12 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 6 Aug 2010 18:18:12 +0000 (UTC) Cc: help-gnu-emacs@gnu.org To: Richard Riley Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Fri Aug 06 20:18:10 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 1OhRUe-00059t-Dw for geh-help-gnu-emacs@m.gmane.org; Fri, 06 Aug 2010 20:18:08 +0200 Original-Received: from localhost ([127.0.0.1]:47307 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OhRUd-0004Rf-Q2 for geh-help-gnu-emacs@m.gmane.org; Fri, 06 Aug 2010 14:18:07 -0400 Original-Received: from [140.186.70.92] (port=57530 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OhRU9-0004Qp-Ps for help-gnu-emacs@gnu.org; Fri, 06 Aug 2010 14:17:39 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OhRU7-0005dg-NY for help-gnu-emacs@gnu.org; Fri, 06 Aug 2010 14:17:37 -0400 Original-Received: from mail-vw0-f41.google.com ([209.85.212.41]:39547) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OhRU7-0005dT-LM for help-gnu-emacs@gnu.org; Fri, 06 Aug 2010 14:17:35 -0400 Original-Received: by vws16 with SMTP id 16so7425319vws.0 for ; Fri, 06 Aug 2010 11:17:35 -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=8MGvEoUmOCahfLfZfI8sP9LP7xkg3DXr27Rw/TX0e6k=; b=G3E2ekYZCsYRxwOzEqkRpUgi2RjUW+CZ0RD48kPe+3k665ex7egKw4BvhRX5BPUO5w L029xu/j6dAh7sZsOPJu6XiStzZu21gvRuwOldyqdexWMitsADKOW2N1oSS99BT3CAnl Lpuz80E6i/42msel3NlHVIv8U5uZvLg21X7tI= 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=cnjTGPYzkbe+0QYCgNrWQr8Jg9w+0gCHWCxy9aMBfusGS90lGANx1NN3kT7ZoWN42j lpi/t/0qwGruVDAzL9FbJd9YEgCq3RNRWIufzwl6+96loYZWqgAVc/WYsTV2io8rhRuZ LyXYGQZGJ6YImf4HjeQFU5C83yNUs/7TKwoHw= Original-Received: by 10.220.126.130 with SMTP id c2mr8572425vcs.165.1281118655138; Fri, 06 Aug 2010 11:17:35 -0700 (PDT) Original-Received: by 10.220.188.77 with HTTP; Fri, 6 Aug 2010 11:17:05 -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:74488 Archived-At: 2010/8/6 Richard Riley : > Deniz Dogan writes: > >> 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!) > > Generate the changelog from the VCS in use when you Make the program. > Sometimes the changelog isn't the same as the commit message. The changelog can be more vague in its description of what was changed whereas the commit message may include many details. -- Deniz Dogan