From unknown Mon Aug 18 06:57:40 2025 X-Loop: help-debbugs@gnu.org Subject: bug#28777: Clarifying the temporary documentation update marks in etc/NEWS Resent-From: Phil Sainty Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 10 Oct 2017 10:17:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 28777 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 28777@debbugs.gnu.org Cc: Eli Zaretskii X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.150763060812490 (code B ref -1); Tue, 10 Oct 2017 10:17:01 +0000 Received: (at submit) by debbugs.gnu.org; 10 Oct 2017 10:16:48 +0000 Received: from localhost ([127.0.0.1]:59270 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e1rah-0003FO-Pp for submit@debbugs.gnu.org; Tue, 10 Oct 2017 06:16:47 -0400 Received: from eggs.gnu.org ([208.118.235.92]:35706) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e1raf-0003FA-K8 for submit@debbugs.gnu.org; Tue, 10 Oct 2017 06:16:46 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1e1raZ-0003xo-Ke for submit@debbugs.gnu.org; Tue, 10 Oct 2017 06:16:40 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.0 required=5.0 tests=BAYES_20,FREEMAIL_FROM autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:34833) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1e1raZ-0003xk-H1 for submit@debbugs.gnu.org; Tue, 10 Oct 2017 06:16:39 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:54874) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e1raU-00085B-C4 for bug-gnu-emacs@gnu.org; Tue, 10 Oct 2017 06:16:39 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1e1raO-0003ns-On for bug-gnu-emacs@gnu.org; Tue, 10 Oct 2017 06:16:34 -0400 Received: from smtp-3.orcon.net.nz ([60.234.4.44]:47322) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1e1raI-0003bE-Sw; Tue, 10 Oct 2017 06:16:23 -0400 Received: from [150.107.172.99] (port=10862 helo=[192.168.20.102]) by smtp-3.orcon.net.nz with esmtpa (Exim 4.86_2) (envelope-from ) id 1e1raC-00037r-JQ; Tue, 10 Oct 2017 23:16:16 +1300 References: <08c3b161-174d-1fb7-5df4-bbf7f7d47ee9@orcon.net.nz> <83val1xk58.fsf@gnu.org> <1f3ce5dd-e8b0-6aee-1614-bbe0200baa95@orcon.net.nz> <83y3ox99yb.fsf@gnu.org> <33aed754-b4cf-a75d-837d-14ee596613b1@orcon.net.nz> <83r2ucqqu6.fsf@gnu.org> From: Phil Sainty Message-ID: Date: Tue, 10 Oct 2017 23:16:16 +1300 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.3.0 MIME-Version: 1.0 In-Reply-To: <83r2ucqqu6.fsf@gnu.org> Content-Type: text/plain; charset=utf-8 Content-Language: en-GB Content-Transfer-Encoding: 7bit X-GeoIP: NZ X-Spam_score: -2.9 X-Spam_score_int: -28 X-Spam_bar: -- X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.4 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.4 (----) On 10/10/17 04:32, Eli Zaretskii wrote: >> +++ > > This indication means the change is already described in the manual. > But since the patch doesn't include any doc changes except NEWS, I > presume you decided this shouldn't be mentioned in the manual (and > I agree), so the indication should be "---" instead. I conclude that I'm a little confused about the description of the two marks. I had intentionally used "+++" because "all necessary documentation updates are complete" (but I can see now that this could make "---" redundant, unless both marks were used together). etc/NEWS says: > +++ indicates that all necessary documentation updates are complete. > (This means all relevant manuals in doc/ AND lisp doc-strings.) > --- means no change in the manuals is needed. If I now understand correctly, "---" means that all relevant lisp doc strings have been updated, and "+++" means the same thing and that there have additionally been updates to the manual? If so, then I think this text could be clarified: > +++ indicates that all necessary documentation updates are complete. > (This means all relevant manuals in doc/ AND lisp doc-strings.) > --- indicates that all lisp doc-string updates are complete and > that no change in the manuals is needed. -Phil From unknown Mon Aug 18 06:57:40 2025 X-Loop: help-debbugs@gnu.org Subject: bug#28777: Clarifying the temporary documentation update marks in etc/NEWS Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 10 Oct 2017 12:27:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 28777 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Phil Sainty Cc: 28777@debbugs.gnu.org X-Debbugs-Original-Cc: bug-gnu-emacs@gnu.org Reply-To: Eli Zaretskii Received: via spool by submit@debbugs.gnu.org id=B.150763837532634 (code B ref -1); Tue, 10 Oct 2017 12:27:02 +0000 Received: (at submit) by debbugs.gnu.org; 10 Oct 2017 12:26:15 +0000 Received: from localhost ([127.0.0.1]:59366 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e1tby-0008UI-PC for submit@debbugs.gnu.org; Tue, 10 Oct 2017 08:26:14 -0400 Received: from eggs.gnu.org ([208.118.235.92]:47949) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e1tbw-0008U4-Kl for submit@debbugs.gnu.org; Tue, 10 Oct 2017 08:26:13 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1e1tbn-00030I-Vf for submit@debbugs.gnu.org; Tue, 10 Oct 2017 08:26:07 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:54088) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1e1tbn-000306-TC for submit@debbugs.gnu.org; Tue, 10 Oct 2017 08:26:03 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:38800) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e1tbi-00050w-5x for bug-gnu-emacs@gnu.org; Tue, 10 Oct 2017 08:26:03 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1e1tbe-0002uN-4a for bug-gnu-emacs@gnu.org; Tue, 10 Oct 2017 08:25:58 -0400 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:52833) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e1tbe-0002uJ-0o; Tue, 10 Oct 2017 08:25:54 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2071 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1e1tbd-0004lw-3z; Tue, 10 Oct 2017 08:25:53 -0400 Date: Tue, 10 Oct 2017 15:25:38 +0300 Message-Id: <838tgjqjel.fsf@gnu.org> From: Eli Zaretskii In-reply-to: (message from Phil Sainty on Tue, 10 Oct 2017 23:16:16 +1300) References: <08c3b161-174d-1fb7-5df4-bbf7f7d47ee9@orcon.net.nz> <83val1xk58.fsf@gnu.org> <1f3ce5dd-e8b0-6aee-1614-bbe0200baa95@orcon.net.nz> <83y3ox99yb.fsf@gnu.org> <33aed754-b4cf-a75d-837d-14ee596613b1@orcon.net.nz> <83r2ucqqu6.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -5.0 (-----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > From: Phil Sainty > Cc: Eli Zaretskii > Date: Tue, 10 Oct 2017 23:16:16 +1300 > > etc/NEWS says: > > > +++ indicates that all necessary documentation updates are complete. > > (This means all relevant manuals in doc/ AND lisp doc-strings.) > > --- means no change in the manuals is needed. > > If I now understand correctly, "---" means that all relevant lisp doc > strings have been updated, and "+++" means the same thing and that > there have additionally been updates to the manual? > > If so, then I think this text could be clarified: Thanks, I've clarified it. From debbugs-submit-bounces@debbugs.gnu.org Tue Oct 10 08:37:35 2017 Received: (at control) by debbugs.gnu.org; 10 Oct 2017 12:37:35 +0000 Received: from localhost ([127.0.0.1]:59393 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e1tmx-0000Lt-Ci for submit@debbugs.gnu.org; Tue, 10 Oct 2017 08:37:35 -0400 Received: from eggs.gnu.org ([208.118.235.92]:52836) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e1tmw-0000Li-B4 for control@debbugs.gnu.org; Tue, 10 Oct 2017 08:37:34 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1e1tml-0002Og-Sz for control@debbugs.gnu.org; Tue, 10 Oct 2017 08:37:29 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:53061) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e1tml-0002OY-Q1 for control@debbugs.gnu.org; Tue, 10 Oct 2017 08:37:23 -0400 Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2098 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1e1tml-0005NV-6X for control@debbugs.gnu.org; Tue, 10 Oct 2017 08:37:23 -0400 Date: Tue, 10 Oct 2017 15:37:08 +0300 Message-Id: <834lr7qivf.fsf@gnu.org> From: Eli Zaretskii To: control@debbugs.gnu.org In-reply-to: <838tgjqjel.fsf@gnu.org> (message from Eli Zaretskii on Tue, 10 Oct 2017 15:25:38 +0300) Subject: Re: bug#28777: Clarifying the temporary documentation update marks in etc/NEWS References: <08c3b161-174d-1fb7-5df4-bbf7f7d47ee9@orcon.net.nz> <83val1xk58.fsf@gnu.org> <1f3ce5dd-e8b0-6aee-1614-bbe0200baa95@orcon.net.nz> <83y3ox99yb.fsf@gnu.org> <33aed754-b4cf-a75d-837d-14ee596613b1@orcon.net.nz> <83r2ucqqu6.fsf@gnu.org> <838tgjqjel.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) close 28777 thanks