From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: The netsec thread Date: Fri, 23 Aug 2019 17:40:04 +0300 Message-ID: <83k1b4j67v.fsf@gnu.org> References: <834l36koak.fsf@gnu.org> <87pnlg7r83.fsf@mouse.gnus.org> <87o90gd1us.fsf@mouse.gnus.org> <838srkb64w.fsf@gnu.org> <83wof4jcrd.fsf@gnu.org> <83pnkwjaoq.fsf@gnu.org> <83mug0j7c6.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="251598"; mail-complaints-to="usenet@blaine.gmane.org" Cc: larsi@gnus.org, emacs-devel@gnu.org To: Robert Pluim Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Aug 23 16:43:24 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1i1Amg-0013GQ-1q for ged-emacs-devel@m.gmane.org; Fri, 23 Aug 2019 16:43:22 +0200 Original-Received: from localhost ([::1]:57186 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i1Ame-0000wW-4q for ged-emacs-devel@m.gmane.org; Fri, 23 Aug 2019 10:43:20 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51927) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i1AjP-0006J3-7E for emacs-devel@gnu.org; Fri, 23 Aug 2019 10:40:01 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:43818) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1i1AjO-0006wo-0Q; Fri, 23 Aug 2019 10:39:59 -0400 Original-Received: from [176.228.60.248] (port=4055 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1i1AjK-0003gD-B4; Fri, 23 Aug 2019 10:39:55 -0400 In-reply-to: (message from Robert Pluim on Fri, 23 Aug 2019 16:27:59 +0200) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:239524 Archived-At: > From: Robert Pluim > Cc: larsi@gnus.org, emacs-devel@gnu.org > Date: Fri, 23 Aug 2019 16:27:59 +0200 > > Eli> If this is your interpretation of what NEWS says, then we must modify > Eli> that text to be less ambiguous. "+++" means the doc strings AND the > Eli> manuals have been updated, "---" means the doc string WITHOUT manuals > Eli> were updated. > > That was indeed my interpretation. > > Eli> These markers are there for when we are close to releasing a new major > Eli> version, and need to make sure everything that needs to be in the > Eli> manuals is in the manuals. It therefore makes no sense to mark by > Eli> "+++" changes that do not need to be in the manuals, because that > Eli> sends the wrong signal. > > So in this case weʼd use '---'. Yes. > Itʼs all clear to me now, but youʼre right that perhaps a different > wording would be better (of course it could just be a problem in my > brain :-) ) If you can suggest a better wording, please do. One possible way is to simply remove the reference to the doc strings, as they are not relevant to the job these markers should do (doc strings should be adjusted as part of any change).