From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Bastien Newsgroups: gmane.emacs.bugs Subject: bug#41497: 28.0.50; Flawed text formatting of files like etc/TODO, etc/NEWS, etc. Date: Mon, 01 Jun 2020 08:29:38 +0200 Organization: GNU Message-ID: <87lfl7jo31.fsf@gnu.org> References: <87wo51voa8.fsf@bzg.fr> <83y2p9l7vi.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="10172"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: 41497-done@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Mon Jun 01 08:30:18 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1jfdxh-0002ZI-TX for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 01 Jun 2020 08:30:17 +0200 Original-Received: from localhost ([::1]:53860 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jfdxg-00068r-Ur for geb-bug-gnu-emacs@m.gmane-mx.org; Mon, 01 Jun 2020 02:30:16 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40794) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jfdxS-00068f-CV for bug-gnu-emacs@gnu.org; Mon, 01 Jun 2020 02:30:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:51036) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jfdxS-0002Se-3Y for bug-gnu-emacs@gnu.org; Mon, 01 Jun 2020 02:30:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jfdxR-0004mh-VP for bug-gnu-emacs@gnu.org; Mon, 01 Jun 2020 02:30:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Bastien Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 01 Jun 2020 06:30:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 41497 X-GNU-PR-Package: emacs Original-Received: via spool by 41497-done@debbugs.gnu.org id=D41497.159099298818349 (code D ref 41497); Mon, 01 Jun 2020 06:30:01 +0000 Original-Received: (at 41497-done) by debbugs.gnu.org; 1 Jun 2020 06:29:48 +0000 Original-Received: from localhost ([127.0.0.1]:34349 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jfdxD-0004lt-Oh for submit@debbugs.gnu.org; Mon, 01 Jun 2020 02:29:47 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:33334) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jfdxC-0004li-Qz for 41497-done@debbugs.gnu.org; Mon, 01 Jun 2020 02:29:47 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:42227) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jfdx7-0002G5-J8 for 41497-done@debbugs.gnu.org; Mon, 01 Jun 2020 02:29:41 -0400 Original-Received: from [2a01:e35:2fe1:f780:a886:3d11:7807:868b] (port=35370 helo=guerry) by fencepost.gnu.org with esmtpsa (TLS1.2:DHE_RSA_AES_256_CBC_SHA256:256) (Exim 4.82) (envelope-from ) id 1jfdx6-0001ik-Ms; Mon, 01 Jun 2020 02:29:41 -0400 Original-Received: by guerry (Postfix, from userid 1000) id 5D4CB1A603C1; Mon, 1 Jun 2020 08:29:38 +0200 (CEST) In-Reply-To: <83y2p9l7vi.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 30 May 2020 19:12:17 +0300") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:181325 Archived-At: Eli Zaretskii writes: > I fixed etc/TODO on the emacs-27 branch. Thanks a lot! etc/TODO can be read with org-mode and that's a nice improvement to me. > As for etc/NEWS, we usually > fix it shortly before the release, so please look at NEWS on the > emacs-27 branch, and if you see problems there, please point them > out. I have seen some problems, like sentences that start as the headline and continue as the paragraph below. Shall I fix these in emacs-27 directly? Also, I don't really understand the use (and need) for the +++/--- convention. The file says: Temporary note: +++ indicates that all relevant manuals in doc/ have been updated. --- means no change in the manuals is needed. When you add a new item, use the appropriate mark if you are sure it applies, and please also update docstrings as needed. So, +++ both mean that no action is needed, either because the manuals have been updated already or because they don't need any update. If this is meant as a call to action for Emacs maintainers, what is it (since both say that things are okay)? If this is meant to the users, what info is conveyed here? What means "Temporary note": is it because --- and +++ are removed right before the release? What about getting rid of --- and +++ in these files and moving the message is conveys (about the need for an update of the manuals) in the etc/TODO file, or in a dedicated etc/PRERELEASE file? -- Bastien