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:15:53 +0300 Message-ID: <83mug0j7c6.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> 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="131067"; 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:16:09 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 1i1AML-000XxW-DF for ged-emacs-devel@m.gmane.org; Fri, 23 Aug 2019 16:16:09 +0200 Original-Received: from localhost ([::1]:56568 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i1AMJ-0001BS-Dl for ged-emacs-devel@m.gmane.org; Fri, 23 Aug 2019 10:16:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47467) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i1AM4-000195-U2 for emacs-devel@gnu.org; Fri, 23 Aug 2019 10:15:53 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:43374) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1i1AM4-0006KC-Nw; Fri, 23 Aug 2019 10:15:52 -0400 Original-Received: from [176.228.60.248] (port=2588 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1i1AM2-0001yN-49; Fri, 23 Aug 2019 10:15:51 -0400 In-reply-to: (message from Robert Pluim on Fri, 23 Aug 2019 15:20:47 +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:239522 Archived-At: > From: Robert Pluim > Cc: larsi@gnus.org, emacs-devel@gnu.org > Date: Fri, 23 Aug 2019 15:20:47 +0200 > > >>>>> On Fri, 23 Aug 2019 16:03:33 +0300, Eli Zaretskii said: > > Eli> If it is not in the manual, why is it marked "+++"? > > NEWS says: > > Temporary note: > +++ indicates that all necessary documentation updates are complete. > (This means all relevant manuals in doc/ AND lisp doc-strings.) > > The doc-string is up to date => +++. Itʼs an obscure, hopefully > never-to-be-used option, so I donʼt feel it needs to be in the manual > (you yourself said something similar very recently about > 'ispell-skip-html' :-) ) If this is your interpretation of what NEWS says, then we must modify that text to be less ambiguous. "+++" means the doc strings AND the manuals have been updated, "---" means the doc string WITHOUT manuals were updated. These markers are there for when we are close to releasing a new major version, and need to make sure everything that needs to be in the manuals is in the manuals. It therefore makes no sense to mark by "+++" changes that do not need to be in the manuals, because that sends the wrong signal.