From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Karl Fogel Newsgroups: gmane.emacs.devel Subject: Re: Is it time to drop ChangeLogs? Date: Tue, 08 Mar 2016 11:18:40 -0600 Message-ID: <87io0w6g7j.fsf@red-bean.com> References: <56BE7E37.3090708@cs.ucla.edu> <4hd1rw1ubr.fsf@fencepost.gnu.org> <83vb50wxhv.fsf@gnu.org> <87y49vz4cg.fsf@acer.localhost.com> <64a52598-ad53-498c-993c-67d7827dbdfc@default> <838u1uuuau.fsf@gnu.org> <878u1um2xl.fsf@thinkpad.rath.org> Reply-To: Karl Fogel NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" X-Trace: ger.gmane.org 1457457553 5394 80.91.229.3 (8 Mar 2016 17:19:13 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 8 Mar 2016 17:19:13 +0000 (UTC) Cc: emacs-devel@gnu.org To: Lars Magne Ingebrigtsen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Mar 08 18:18:56 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1adLHb-0001JJ-HN for ged-emacs-devel@m.gmane.org; Tue, 08 Mar 2016 18:18:55 +0100 Original-Received: from localhost ([::1]:36194 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1adLHb-0002Fv-0q for ged-emacs-devel@m.gmane.org; Tue, 08 Mar 2016 12:18:55 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34259) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1adLHX-0002Fl-4Y for emacs-devel@gnu.org; Tue, 08 Mar 2016 12:18:51 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1adLHS-0008Dz-3u for emacs-devel@gnu.org; Tue, 08 Mar 2016 12:18:51 -0500 Original-Received: from mail-ig0-x22a.google.com ([2607:f8b0:4001:c05::22a]:34368) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1adLHR-0008Dn-TJ for emacs-devel@gnu.org; Tue, 08 Mar 2016 12:18:46 -0500 Original-Received: by mail-ig0-x22a.google.com with SMTP id ir4so80518618igb.1 for ; Tue, 08 Mar 2016 09:18:45 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:reply-to:date:in-reply-to :message-id:user-agent:mime-version; bh=SXX24rykUEkNpLGbtPwWar6QA+1Em7GsLfqPJxXcHWM=; b=mbbUrqLp53s6IN/PJtO8P3Ok7Q5bCXp/cZuZ/z04uSSEx2oUvgN+SPwfjUmoNDlZIt b66P60+4RbUw5jMxlWVkW6JZGYwz0ZsUF//UVVeIGDWZ09Jgbnf60j2OrejHUWQ9pVeT 1RAVxcFcrRXe7ooe/v/CnMIghUx79NTYXzhPOXZWio+Uqk+nV3Dee3ZPafP0hmCj8ntR muWvSEVzYXDZnHaEN+s5j5VyrMOI5zQhbS78X7wTkzC/GQrBY20pwSJVbNWXUSwZQsdz fUNpeaMrt2Z+7HVe7T881/GycPLaKXR+rXEjzcsx8fKr1g0wH7arXcqdfoOHHaUNSdaF fQ4A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:from:to:cc:subject:references:reply-to :date:in-reply-to:message-id:user-agent:mime-version; bh=SXX24rykUEkNpLGbtPwWar6QA+1Em7GsLfqPJxXcHWM=; b=NNPhxaWl9ii/URyTIKiIsWghFXUXhFRdyM0CI1G7qj7vo469KSMiEoFcFKPMnWGrb9 mZTLbVgQ6kbfKI8HybU6xa2TP7hIdXPEdzLqAq+8F2yehqtbAxz6wveK5rnBD4yZgwSe vTj8MQNsVfpTvXj5Xtq7pwUiKvyba2TD/NQ1iw7FyyPapp5rs6vitMy9wAYP3ykuHwTG QuUBpOQTS+gsuiNhHCdzi0Wu7nRFa7IMiU98LnnJIFBSHKGJyyMPg5jQTpmFejSaabTE yCsBSp8yRHWqrs/lopNcBTlsCNoKdA9CysGWc9diNcS9DmLRhi5Oy5teWVEU2cHJynTc p3bg== X-Gm-Message-State: AD7BkJIRl7DtqM4oiCsTY3JEYzGPZ5LKVzKi2QfzJF9oQJ3D3YI/x4BQJ5GdhOBJbvRBDA== X-Received: by 10.50.64.242 with SMTP id r18mr18226450igs.65.1457457525417; Tue, 08 Mar 2016 09:18:45 -0800 (PST) Original-Received: from floss (74-92-190-114-Illinois.hfc.comcastbusiness.net. [74.92.190.114]) by smtp.gmail.com with ESMTPSA id 40sm1483182iom.28.2016.03.08.09.18.44 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 08 Mar 2016 09:18:44 -0800 (PST) In-Reply-To: (John Wiegley's message of "Tue, 08 Mar 2016 08:54:29 -0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.92 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:4001:c05::22a X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:201181 Archived-At: --=-=-= Content-Type: text/plain John Wiegley writes: > 2. At some future date, should the main contributors no longer rely on or > want a separate ChangeLog file, we should: > > - Remove ChangeLogs from version control. > - Require ChangeLog format entries in the commit message, as long as it > helps us and improves the quality of contributed commit messages. > - Employ some mechanism, such as git notes, to amend incorrect log > messages when generating metadata for the release tarball. Aren't we doing that middle item already? As I read the CONTRIBUTE file, the section on "commit messages" basically says to use ChangeLog style. Which is good. Since a ChangeLog entry is always suitable as a commit message (i.e., there is no good ChangeLog entry which wouldn't work fine as the commit message for the associated commit too), then there's no time like the present to start having a commit message convention we can all agree on. Since we've already agreed on ChangeLog-style entries for ChangeLogs, I think we would also agree on it for commit messages... and CONTRIBUTE suggests that we have already done so. This is orthogonal to whether we keep ChangeLog *files* in the tree, of course. It just settles that we have one unified convention for log messages, and that convention applies to both of the places where log messages can be stored: in commit messages, and in ChangeLog files. So the only remaining question is about where information should be stored (and, if there is duplication, whether that duplication should be maintained manually or automatically). The question of what the information looks like is, I hope, already settled. -Karl --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQIcBAEBCgAGBQJW3wlzAAoJEAigt1zF7YNF8ZgP/ihkzbfsMrJxOeNZeW8vi0I+ yzTLtPUI/ANw70w13wpa8Vuylh92tw3BRVxeaji/OuIWylBp+m1KNE48nU4N2qSP HBEc4nZ5fL5KBGflR0mJ5kKSo9aO1E4ww5d/8kP/5Lh8VyIdh8mxIdcNuTbB7llx PNKmjPPX/s5WvxzizPPB4W3sGBxQdK0na4yBsIfhuQpfmfFvceO6IQTEirSjlLzQ OqKUs/8asv8VnHtno9VTYuuADHZlAAN3ajeVkhr/xeBdaXo/ee71CitxfIRHFzia eqkdgi2DYVs/m7hZYDIQgxAEN4f2u5IXhjId02JFFo9EQ4mmjgy8Ku6LL1rE3vY0 aPc5Sh7qdGPG/RWpWui8onI6oH4I0uOjnT9r2xxqCNesz6z2dQKQE/ah5Tkjzb0+ a4IMMqKpwHD7r/YShbpt5mL0yGdSKXHIbqvzBnU1z6U79vZ2xQp4Sg3MBehLjdTc iP9y8188BtPOx5XKkOZ6yygyroDqEChaUDq0GCxUH7SfSDPKEsG1paERsXHyJ1Ey gkLzvwOkQxpheFDTZokfRFAb8diAGRNRwNfuOE7VSGx65jroZhLj0PE0Iu3lKj9+ wYTi76xwR9Bef/L01WPqm/ZeT5LJ18Hq1OOzK3F8dRMMFppacCLwsLOF0TpRYvGZ UHNx2MB6fL11XjZiMnzn =bKk2 -----END PGP SIGNATURE----- --=-=-=--