From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id E0BD8385481A for ; Wed, 17 Mar 2021 15:41:00 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org E0BD8385481A Received: from fencepost.gnu.org ([2001:470:142:3::e]:38205) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lMYI8-0001sy-Gb; Wed, 17 Mar 2021 11:41:00 -0400 Received: from 84.94.185.95.cable.012.net.il ([84.94.185.95]:2188 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1lMYI7-0007aS-F7; Wed, 17 Mar 2021 11:41:00 -0400 Date: Wed, 17 Mar 2021 17:40:56 +0200 Message-Id: <83mtv1dbzr.fsf@gnu.org> From: Eli Zaretskii To: Luis Machado Cc: vapier@gentoo.org, gdb@sourceware.org In-Reply-To: <18f4f0e2-0a35-a6c5-1886-943f81f817fd@linaro.org> (message from Luis Machado on Wed, 17 Mar 2021 12:22:46 -0300) Subject: Re: sim: replacing ChangeLog files with online git logs References: <83ft0zjys1.fsf@gnu.org> <83lfarhwjq.fsf@gnu.org> <83eegjhuuq.fsf@gnu.org> <8335wyj461.fsf@gnu.org> <83tup9disi.fsf@gnu.org> <2012fb21-38f2-3d1c-62c8-52d94d19e243@linaro.org> <83pmzxdegd.fsf@gnu.org> <83o8fhddg3.fsf@gnu.org> <18f4f0e2-0a35-a6c5-1886-943f81f817fd@linaro.org> X-Spam-Status: No, score=1.7 required=5.0 tests=BAYES_00, KAM_DMARC_STATUS, RCVD_IN_BARRACUDACENTRAL, SPF_HELO_PASS, SPF_PASS, TXREP autolearn=no autolearn_force=no version=3.4.2 X-Spam-Level: * X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: gdb@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 17 Mar 2021 15:41:02 -0000 > Cc: vapier@gentoo.org, gdb@sourceware.org > From: Luis Machado > Date: Wed, 17 Mar 2021 12:22:46 -0300 > > Given the idea is to drop ChangeLog files for sim/ (for reasons Mike has > exposed), it would make no sense to keep embedding a manually-written > ChangeLog entry in the git commit message. So the only two sections left > in the commit message would be the subject line and the description. That doesn't have to be so, though. How to format the Git log messages when ChangeLog files are dropped is a separate discussion. > The list of changes would be auto-generated by a script, but it will > certainly be less descriptive than a manually-written ChangeLog entry. > It will only list things like "modified" or "new file". > > > > > For example, in Emacs we ask contributors to format the Git log > > messages according to ChangeLog format, and then the generated > > ChangeLog file looks exactly like the manual one would. > > > > I may be mistaken, but I think the idea is to drop ChangeLog > dependencies even from commit messages. That will simplify the > contribution process given ChangeLog files/entries will be > auto-generated by the mentioned script. The list of files touched by a changeset can be easily generated, but the functions/macros/classes not so easily, and not necessarily accurately enough, even if we will use the more elaborate script that is used by glibc. So some information loss will be present. OTOH, the ChangeLog-format Git log messages don't require one to have the ChangeLog file, they just require to use the same format when describing the changeset. If you use Emacs to make the changes themselves and commit the changes into Git, you just need to use the Emacs commands to format the Git log messages, those commands will produce the same information as the manual ChangeLog files automatically. If that is not an option that this community wants to adopt, then gitlog-to-changelog is probably not the adequate solution, and we should try using vcs-to-changelog.py (also in Gnulib).