From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Po Lu Newsgroups: gmane.emacs.devel Subject: Re: ChangeLog and commit messages Date: Tue, 20 Jun 2023 08:55:12 +0800 Message-ID: <87o7lb54wf.fsf@yahoo.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> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="2973"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 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 Jun 20 02:55:58 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 1qBPf3-0000Zu-Rc for ged-emacs-devel@m.gmane-mx.org; Tue, 20 Jun 2023 02:55:57 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qBPeb-0002SG-4a; Mon, 19 Jun 2023 20:55:29 -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 1qBPeZ-0002P9-Ql for emacs-devel@gnu.org; Mon, 19 Jun 2023 20:55:27 -0400 Original-Received: from sonic301-30.consmr.mail.ne1.yahoo.com ([66.163.184.199]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qBPeV-0002ng-M4 for emacs-devel@gnu.org; Mon, 19 Jun 2023 20:55:26 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1687222521; bh=xpOMmwFTAMKLK8VlF4PS+/Fi34fjArnKGp/ITzKMEHo=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From:Subject:Reply-To; b=gFHbOdENUDqry/1c4XTSj53ClyXH+khRFRNviIB1CuyFHyM54XHZ+XbZes7/a2jbie6v5dmaBgzhszBM6Meh+RLF3NolicsN8m5176YUBD4Novascan80fvgQ3vo+reRihJGIFLATqyTLEfNRgUq4WpylhC5xNE3VS/jQ3E/pg2Xicl9ZjKRbDC7+seVNM+O35hcMbH9kY1t/T8GfCO643zkY5KkjaBM0nElXerIRabZWen7Zdzg4PISv1fZGB+6qu5mpFPL2VY3bU7/qWsPGbgihXmh09o/FUEbn9e34kYaFz9rXhPi9mtJxQzvLT2aHWS7JRa09phDzzfh4NKqTw== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1687222521; bh=37iFKPv8h0UTSux7HpRWthxXedmY0uyzr1pRiK0i4Ac=; h=X-Sonic-MF:From:To:Subject:Date:From:Subject; b=CcnwzMBHfGX8Ms2Yv2BI/6QrnRYT0TDc1FejE425F6yeFqKoAvHv5Rsa0qC76IITsSv6sE4uG4XDmvFCC2HygP77D20C7fhosBEsFCdFckVwn4tZcwTTo4EVwLjhBqlApgJ9e6bTrxSPPzI4yNOM9Mh75iMlkX06FSjSHc2CcKKCYPAOWRjeaKa9haGgFoRy+q/2S6kOeaAXpJZyWumIuhX/qu6GRaTmjwbqnW/GrGJ80LpZKZMIZjJAR9bBtq3/fBWwjPP9fY5a0U10O7T8OCfUQpBowhBA50Rm6yuO5TiBRt1HvUpGBQdeHAqw3+NZrJfKTZG3a3tR4PrrYUiYEw== X-YMail-OSG: m4BvkLwVM1klmXP6CZt1KjQZ93iYSDXFDuwL4lQHXyvwH5ERR_px_fBEQA7fOT2 TrZ4D1h9JUFwmQExgsKpztHIwPgE9pUgr4lLk44FkD4GXAnUT4BKevLV_23hh0g.yLx4hRLi5XE_ VwKTFPlcwxQWFameT0sHzEgfqRkOEGQ7SxMauYVuLVNnIt6SMvQt4jBx98uDjilrhc7ZyLAEdX4D Fp3eoVUw8GOxHHxDGTg4Q.Lzd4CFCfP9DuuMDAQJ7N9REuB905Dfk7WajMiy0ecjlnl5MzHLaeqK K9ijKHGl2vlXBnrrc1.X.YQO3S21qu2UKDTZaFujGRVpLbUntEsMXGakVWENy3aOKfV2GSTh6jBD qpZGyiaWGK1ksmJebGezrNkdSGAXNBqDDg7C71jvfi66U4xitnbbxOYA52R7r.Vt5xtA1qqz4vKe pdfGC1vSyLs7r51bqECHOzU4koTXv_f0Uo7h1rQAimVgjHCllCMHFWt1QGjsGqUaZpv2yn.7JfxE OTJb9eJUCGoODQVzg1o6Z7x6rjIPfo.Al94g24rVY7JddTsr61VBwLGCl3bm3gjG3QRmz2U7MEgP m6EYsJBq0lo.tAsjU7D3WHk4UdP5EyUN3xTQ4t5HPw7n_cD_52cjJ_aGenjkko44mGhr9WTASCIA 2GMD0.2z3rcFq57Gxl0DfrmnEiLdEWt8MegTY1XOkh6cywZxxMWe.2Yqub6dIZGKTfUWq5Fslmc. BSou5oB3SjVUm0T9OFRCGbDTnDUNpSo9I2vphVw107mY7YaN_pJh7Rxfsj8xOxs2RW1A_JFdQNlC CXUUZ0WyT.y.bEU0ltJhWYJkEDNCW4LF1IlQxTMbto X-Sonic-MF: X-Sonic-ID: 51031559-0c34-48b1-a495-9bd6019222df Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic301.consmr.mail.ne1.yahoo.com with HTTP; Tue, 20 Jun 2023 00:55:21 +0000 Original-Received: by hermes--production-sg3-748897c457-gjhr4 (Yahoo Inc. Hermes SMTP Server) with ESMTPA ID e7b3345864a510d854a255f3bd1e52bf; Tue, 20 Jun 2023 00:55:17 +0000 (UTC) In-Reply-To: <834jn38l8t.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 19 Jun 2023 19:33:54 +0300") X-Mailer: WebService/1.1.21557 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo Received-SPF: pass client-ip=66.163.184.199; envelope-from=luangruo@yahoo.com; helo=sonic301-30.consmr.mail.ne1.yahoo.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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-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:307065 Archived-At: Eli Zaretskii writes: > 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" > > This leaves you with the need to come up with a commit log for when > the branch is landed. That might sometimes be a large job, but it > will be much smaller than the sum total of what you do now. Moreover, > what you do now will not help you avoid this job, because we do > require3 a meaningful summary log message for when the branch is > merged. OK, thanks for explaining.