From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.devel Subject: Re: Should we restore manually maintained ChangeLogs Date: Tue, 8 Mar 2016 01:05:29 +0200 Message-ID: References: <56BE7E37.3090708@cs.ucla.edu> <4hd1rw1ubr.fsf@fencepost.gnu.org> <83vb50wxhv.fsf@gnu.org> <87y49vz4cg.fsf@acer.localhost.com> <87vb4zb0i4.fsf@gnu.org> <837fheuu6a.fsf@gnu.org> <83twkiteb3.fsf@gnu.org> <86si02upt3.fsf@gmail.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1457391962 22454 80.91.229.3 (7 Mar 2016 23:06:02 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 7 Mar 2016 23:06:02 +0000 (UTC) To: Andy Moreton , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Mar 08 00:05:57 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 1ad4Ds-0004ok-5l for ged-emacs-devel@m.gmane.org; Tue, 08 Mar 2016 00:05:56 +0100 Original-Received: from localhost ([::1]:59114 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ad4Dr-0003bd-Gk for ged-emacs-devel@m.gmane.org; Mon, 07 Mar 2016 18:05:55 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54190) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ad4Dd-0003bT-Hr for emacs-devel@gnu.org; Mon, 07 Mar 2016 18:05:42 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ad4DZ-00038u-F4 for emacs-devel@gnu.org; Mon, 07 Mar 2016 18:05:41 -0500 Original-Received: from mail-wm0-x22f.google.com ([2a00:1450:400c:c09::22f]:37984) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ad4DZ-00038q-5v for emacs-devel@gnu.org; Mon, 07 Mar 2016 18:05:37 -0500 Original-Received: by mail-wm0-x22f.google.com with SMTP id l68so5398472wml.1 for ; Mon, 07 Mar 2016 15:05:37 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:subject:to:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-transfer-encoding; bh=w5OJv4GIAkBa5Zd+Hyhm3hd+SyszTfWTNf+zNHoKarI=; b=n/+tKow+OJnfc9RpSaNYI4z0nUGm7rC/wfcHbcw8hRL5P5jivBgiR/EgvCw4eNZfuJ TsZEb7FXFlVTBEpjA52IPv5DWpblLAwBN7TxT3xUZZHN6J1N3YdpZgV0D0d6OoFOICBN Ne1vU2A4VAi2sZ3LeIUq+z2NX4Sh5RY7buow4OBehaJqd2VK/DWNlV9PQ8TAXX3ZVlrV FZA4ubS8POT/N/JlhIsEeBQFCLuMGqZkJkbb0ufaasSMQXYD3dkW24+r+1tkL2aX3dGg F/Hj8xv100zs0QF65SQTt4Jz4wTVK6WFhIauSTHxalVdQ0G81bzL1tYgMTReYrh4UWa7 8Ing== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:subject:to:references:from:message-id :date:user-agent:mime-version:in-reply-to:content-transfer-encoding; bh=w5OJv4GIAkBa5Zd+Hyhm3hd+SyszTfWTNf+zNHoKarI=; b=aA6+/gV4hu+SiLImU2rth7+iaJygYhIle0DFQqBsnCBds/9ryLvjFv91BRV42o58d6 mHn7IUaZMhrxnpOL9kwF2rFdMVZgijNE7atdxZdXXqT0WjdmMfUnD3zwmYuUOJwcmcwz PVMSoa7MVUQf0yp7nJt0PIOI22ua0mDHkG0Yt6PJm1M4PmtpbSKWd7ZTQCuM7bu0mi+z /lYBR5TN2IvUB3T+tGxx+i7vTEc1kFycyTJW932/rWmUKK1iOzpjYmyb02yM7leNfBod gSpmflWeuM6gXu89NdFn6CQKxNQElqgYGmv1GwqwszrPILzTAPWLQxU6KMkFcYm+GOhS +LoQ== X-Gm-Message-State: AD7BkJLUm7RRRApB/o+TTNKzvFVhxetRWT7n6bVklHZ0SSwNHqR5ih82aRfPOk7blmK1dw== X-Received: by 10.28.188.5 with SMTP id m5mr9620949wmf.35.1457391936586; Mon, 07 Mar 2016 15:05:36 -0800 (PST) Original-Received: from [192.168.1.2] ([185.105.175.24]) by smtp.googlemail.com with ESMTPSA id 77sm15987732wmp.18.2016.03.07.15.05.34 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 07 Mar 2016 15:05:36 -0800 (PST) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.0 In-Reply-To: <86si02upt3.fsf@gmail.com> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2a00:1450:400c:c09::22f 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:201096 Archived-At: On 03/07/2016 08:05 PM, Andy Moreton wrote: > Commit messages should show both what motivates the need for a patch > (bugfix, new feature etc), and why the approach chosen is better than > other possible designs. Not to say there's no place for improvement in our commit messages, but keeping the actual explanation separately (in a bug report, in in a mailing list message), and linking to it from the commit message is entirely fine in my book. In certain cases, it's hard to avoid that anyway (the explanation is too verbose/hard to summarize/etc). > The Linux kernel documentation has a good description of what is needed > in a commit message in section 2 of Documentation/SubmittingPatches. It's a fine description, but it's huge compared to the Change Log format description (thus raising the barrier of entry if we decide to use it officially), and ultimately, it leaves a lot up to the patch author's judgment anyway.