From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Sean Whitton Newsgroups: gmane.emacs.devel Subject: Re: ChangeLog and commit messages Date: Tue, 27 Aug 2024 12:23:46 +0800 Message-ID: <87y14ik2zx.fsf@melete.silentflame.com> References: <87a5wxb5sl.fsf.ref@yahoo.com> <87a5wxb5sl.fsf@yahoo.com> <837cs1p6bf.fsf@gnu.org> <875y7lb4k7.fsf@yahoo.com> <327d575ab075bf4e92ca00c11548a62458fec75b.camel@yandex.ru> <87r0q86zvd.fsf@yahoo.com> <87jzw06j1y.fsf@yahoo.com> <834jn38l8t.fsf@gnu.org> <87ttuyvfhv.fsf@melete.silentflame.com> <83y1ka1weg.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="21423"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: luangruo@yahoo.com, hi-angel@yandex.ru, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Tue Aug 27 06:24:36 2024 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 1sinkx-0005Lj-16 for ged-emacs-devel@m.gmane-mx.org; Tue, 27 Aug 2024 06:24:35 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sinkO-000443-Bu; Tue, 27 Aug 2024 00:24:00 -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 1sinkM-00043p-Pc for emacs-devel@gnu.org; Tue, 27 Aug 2024 00:23:58 -0400 Original-Received: from sendmail.purelymail.com ([34.202.193.197]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sinkL-0008Ta-C8 for emacs-devel@gnu.org; Tue, 27 Aug 2024 00:23:58 -0400 DKIM-Signature: a=rsa-sha256; b=eLKKRnWAANxcM+hFQ5835FLR8fzWJ26MY7LP5dyrPuYtyiEgQowjbaQHuYtM3Qg8K9T2sYt+a5Cx6gaO+0ekdWdcGgtbkKdk0EU3xeCPocXEDoEolB+kkOaQ5SWi1b565fxNtIff7dDb0ulnapfm5FbKJ/5epTgT11qvTQPdl/PVJsMdTmW2lurEBWsnD2J4W0YptnYQiwn5boXszDYx/zCUGJVx/JYYHoW1mtxlS+SGvCLYjYJYyd9DZ7tPLJjqQYjG+P6jbxlFEvKaBQShwGcI/wdj3I0sWVfcaXSTXjIOs7VCJhCA9NP1fdE7Rigidy5XfnMzYLYs9uc52oLRJg==; s=purelymail3; d=spwhitton.name; v=1; bh=zHAO6rXP6e2MjulMHUxh3PRSODDsinx0beni4qg63PA=; h=Received:Received:From:To:Subject:Date; DKIM-Signature: a=rsa-sha256; b=OOFDxltPYzhR1KJTdjK+0dQIGdeg5n5gE32C/ebKR+csv+QQkzD+6fdLHSUYDvHZAyFOefzCBFJ8T+ntWEz3KyyGyoWxWXW2VP4FYr9E+9r0UQLznoLw6uxeUXFE6t7x7vXhwi9m7EOGSs/eEI6LtETY2g2YNFiRYGkHrpbwlz1F+M87tWGH7gcLfP5pFaCIlQqlvsEbUTSaZ1VBj+ivBAARdtjHy3D2Cwlm7x+wk8xDQbECAfc8luOPt99Tgo128/+bMzGqmFXvO6CV+IVWaorORHggusKx5Pn7ub51Pg538WC2rtgnNcSRaEgQixSZTGBJSBErwHwQdocB0+B+Mw==; s=purelymail3; d=purelymail.com; v=1; bh=zHAO6rXP6e2MjulMHUxh3PRSODDsinx0beni4qg63PA=; h=Feedback-ID:Received:Received:From:To:Subject:Date; Feedback-ID: 20115:3760:null:purelymail X-Pm-Original-To: emacs-devel@gnu.org Original-Received: by smtp.purelymail.com (Purelymail SMTP) with ESMTPSA id 1973561210; (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384); Tue, 27 Aug 2024 04:23:50 +0000 (UTC) Original-Received: by melete.silentflame.com (Postfix, from userid 1000) id 908F67EA244; Tue, 27 Aug 2024 12:23:46 +0800 (CST) In-Reply-To: <83y1ka1weg.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 23 Jun 2023 10:16:07 +0300") Received-SPF: pass client-ip=34.202.193.197; envelope-from=spwhitton@spwhitton.name; helo=sendmail.purelymail.com 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, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=unavailable 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:323135 Archived-At: Hello, On Fri 23 Jun 2023 at 10:16am +03, Eli Zaretskii wrote: >> From: Sean Whitton >> Cc: Po Lu , hi-angel@yandex.ru, emacs-devel@gnu.org >> Date: Fri, 23 Jun 2023 07:50:52 +0100 >> >> On Mon 19 Jun 2023 at 07:33PM +03, Eli Zaretskii wrote: >> >> > If your problems are with the feature branch, then I think you are >> > making your life harder than it needs to be. Our conventions for >> > formatting commit log messages don't apply to feature branches. On >> > feature branches, the developers are free to format the log messages >> > as they see fit; the only log message that matters is the one for the >> > merge-commit which lands the feature branch on master (which you have >> > to create by hand anyway). >> > >> > The upshot of all this is that while you are working on a feature >> > branch: >> > >> > . you can use short single-line note-like log messages, which might >> > be unclear to anyone but yourself >> > . you should generally commit each time when you finish some >> > meaningful changeset, so that it could be later reverted without >> > complications -- this goes well with short log messages >> > . it is futile to use "C-x 4 a"-style log messages, especially for >> > changes in files or in functions the branch adds, because in the >> > final commit log we only need to see "foo: New file" >> >> Is this written down somewhere? > > Not that I know of, no. > >> I had no idea about it. > > Did you work on feature branches of the Emacs Git repository? Very > few people did or do, so having this in the documentation for the > benefit of a very few sounds un-economical. I won't object to having > this in some place in admin/notes [...] Finally installed some additional text for this under admin/notes/. -- Sean Whitton