From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Bruno Haible Newsgroups: gmane.emacs.devel Subject: Re: ChangeLog and commit messages Date: Sun, 18 Jun 2023 16:03:35 +0200 Message-ID: <6359963.hdfAi7Kttb@nimes> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7Bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="21281"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Po Lu Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jun 18 16:04:25 2023 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1qAt0x-0005Kd-KM for ged-emacs-devel@m.gmane-mx.org; Sun, 18 Jun 2023 16:04:23 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qAt0I-0005cu-Sh; Sun, 18 Jun 2023 10:03:43 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qAt0H-0005cR-6q for emacs-devel@gnu.org; Sun, 18 Jun 2023 10:03:41 -0400 Original-Received: from mo4-p00-ob.smtp.rzone.de ([81.169.146.162]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qAt0F-0006iD-DI for emacs-devel@gnu.org; Sun, 18 Jun 2023 10:03:40 -0400 ARC-Seal: i=1; a=rsa-sha256; t=1687097015; cv=none; d=strato.com; s=strato-dkim-0002; b=c/Wxwyea40cLlWds5QhjMQI/wbaWcs3+u8+3zArC0NMoE9FJ7GpdepNh58xcQue6/k 5Kvf7xQHKyspuWGtvovj2oyL8jgzswo9Cj2ZuN4Ptu3IRiOAixU1hXX0/oMA85WiVZet nt1QuM9Y+57ol8ji084NJbtIBBkQ50eH+pikEv1Z8ngEPLzpA9bEZUFO7vZQr7IQRif4 GiSs+Z8sZVRympfhpm3JQd9FgSfnAbAnfb+fiPsaAWozcxMjf5Vf1W4bMPNLCOpWRmmd 9G8Fe/U32lAia+RU6kHvD8hf9eDjTYFD/xkBP8h9vNq11IbwWcy0WPjP9Sn0/VM+Fmbe ZjBA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; t=1687097015; s=strato-dkim-0002; d=strato.com; h=Message-ID:Date:Subject:Cc:To:From:Cc:Date:From:Subject:Sender; bh=btnCtj+LTJoaDuONqOTOrA+aeT7sVXD/lhc3Wk+a1Ko=; b=TRCy9sc5hsGcTtvKislg3rtY15TYInmqgWlRU2ddtYPIzPd22AI06q0IgQ9fdp8Gl0 H7oTaTELC9cF//0Ac6QKEal3XqM0F3Fsw/9iUNYYMLWljSS19DJAOmezYuyMWtm4Ddmm 4Ju7r52HxaSjDOnd3J3DSjCq8aCQ/DinUx5SGIMKoZ05jWnkhMj66lP+28YnfOH8irNY SIDg1ebYMWgj6kZS7h9LOSKR2+ro2wfWGlW4r9f+VCMx0Ez/m8z/lmiy4ABJdY/PrK7A g/f+2T80ro2lHn1B5zpoM+PX6JvpVsAteCdqz5J+hhVz1v8t60T44HMSRqgW50ljPOqU CoYQ== ARC-Authentication-Results: i=1; strato.com; arc=none; dkim=none X-RZG-CLASS-ID: mo00 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; t=1687097015; s=strato-dkim-0002; d=clisp.org; h=Message-ID:Date:Subject:Cc:To:From:Cc:Date:From:Subject:Sender; bh=btnCtj+LTJoaDuONqOTOrA+aeT7sVXD/lhc3Wk+a1Ko=; b=RfIxXn3roRjDb5a1ERpgwUIusoIsKDrEfLtJqCbO0Yrnqe4gaGwGyjdjuAKbKadnZd z3ZPhT0/gxOQ97W8BVTTkmk4+RcZqva839AfOOVhiwfV+UJeUouKeZw2AyFZSBNaIzkD HyXkLI6eVLRo8md2J50oydADZn9GYe59vnyz0Viu+37y3aiPbFmvdRcx1QM7huC5RrCF qTu58Zg2bsQOab1w6LLS0ZaWK3AY1mrCbhfPTpZbmdfAgLoORGDkohsDMtfSnP578B0c GQk21aiFz5DAu4hQhqgNPyaAWYBPxurUYtpSfmO21XROIm/9E3krMAXZMZ4GPK8SRk4n 9ryQ== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; t=1687097015; s=strato-dkim-0003; d=clisp.org; h=Message-ID:Date:Subject:Cc:To:From:Cc:Date:From:Subject:Sender; bh=btnCtj+LTJoaDuONqOTOrA+aeT7sVXD/lhc3Wk+a1Ko=; b=dVioQvuTi9MG8c5u5DMJik4uTynvassZ+e9qlpWy6mfv8UGcfgiskKVkKTKHECT7JO TZ0JqKc+wzWVfu5FpwDQ== X-RZG-AUTH: ":Ln4Re0+Ic/6oZXR1YgKryK8brlshOcZlIWs+iCP5vnk6shH0WWb0LN8XZoH94zq68+3cfpPAjvPAxHVuD+0kJ/DIvVlSmDc7mA==" Original-Received: from nimes.localnet by smtp.strato.de (RZmta 49.6.0 AUTH) with ESMTPSA id 6b0accz5IE3ZRqF (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256 bits)) (Client did not present a certificate); Sun, 18 Jun 2023 16:03:35 +0200 (CEST) Received-SPF: none client-ip=81.169.146.162; envelope-from=bruno@clisp.org; helo=mo4-p00-ob.smtp.rzone.de X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_PASS=-0.001, SPF_NONE=0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:306998 Archived-At: Po Lu wrote: > I find myself often frustrated that Git requires a commit title. In > such a title, committers are expected to summarize in detail changes to > dozens of different functions in less than 74 characters of text. That's a feature, not a bug. The commit title has benefits for the co-developers and for yourself, the committer. Namely: * If I am a co-developer, I want to know - the purpose of the change, - whether I can expect my existing tests or usage to continue working, or whether it will break, - whether I have the opportunity to extend my tests / change my usage. For you, the committer, simply think of someone else asking you "what is the point of this change?". Thinking about this title for 30 seconds gives you the opportunity to - detect when you are about to commit two unrelated things (e.g. a bug fix and a new feature) - if it's a new feature: question yourself whether you have been including necessary documentation changes and/or a NEWS entry. Bruno