From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#29400: 26.0; Add Elisp manual index entry for `defvar' to node `Compiler Errors' Date: Fri, 24 Nov 2017 16:42:39 +0200 Message-ID: <83a7zbagbk.fsf@gnu.org> References: Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1511534692 21578 195.159.176.226 (24 Nov 2017 14:44:52 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 24 Nov 2017 14:44:52 +0000 (UTC) Cc: 29400-done@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Nov 24 15:44:45 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eIFDh-0005AN-2U for geb-bug-gnu-emacs@m.gmane.org; Fri, 24 Nov 2017 15:44:45 +0100 Original-Received: from localhost ([::1]:49624 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eIFDo-0007sG-6z for geb-bug-gnu-emacs@m.gmane.org; Fri, 24 Nov 2017 09:44:52 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35960) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eIFD6-0007U2-VE for bug-gnu-emacs@gnu.org; Fri, 24 Nov 2017 09:44:11 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eIFD1-0007zS-1a for bug-gnu-emacs@gnu.org; Fri, 24 Nov 2017 09:44:08 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:46199) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eIFD0-0007zB-SE for bug-gnu-emacs@gnu.org; Fri, 24 Nov 2017 09:44:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eIFD0-0000Zl-Jn for bug-gnu-emacs@gnu.org; Fri, 24 Nov 2017 09:44:02 -0500 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Fri, 24 Nov 2017 14:44:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 29400 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 29400@debbugs.gnu.org, eliz@gnu.org, drew.adams@oracle.com Original-Received: via spool by 29400-done@debbugs.gnu.org id=D29400.15115346012122 (code D ref 29400); Fri, 24 Nov 2017 14:44:02 +0000 Original-Received: (at 29400-done) by debbugs.gnu.org; 24 Nov 2017 14:43:21 +0000 Original-Received: from localhost ([127.0.0.1]:54871 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eIFCL-0000Y9-9p for submit@debbugs.gnu.org; Fri, 24 Nov 2017 09:43:21 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:44751) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eIFCJ-0000Xt-Or for 29400-done@debbugs.gnu.org; Fri, 24 Nov 2017 09:43:19 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eIFC9-0007N0-L2 for 29400-done@debbugs.gnu.org; Fri, 24 Nov 2017 09:43:14 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:60372) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eIFC9-0007Mf-Hq; Fri, 24 Nov 2017 09:43:09 -0500 Original-Received: from [176.228.60.248] (port=2946 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1eIFC7-0005ck-M7; Fri, 24 Nov 2017 09:43:09 -0500 In-reply-to: (message from Drew Adams on Wed, 22 Nov 2017 08:50:33 -0800 (PST)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:140306 Archived-At: > Date: Wed, 22 Nov 2017 08:50:33 -0800 (PST) > From: Drew Adams > > Node `Compiler Errors' seems to be the only place in the Elisp manual > where we tell users that you can use a vacuous `defvar' (no value) to > suppress a byte-compiler warning about it not being defined. > > But this node has no index entry - at least none that has the word > `defvar' in it. Please add such an entry. I added some index entries, but I don't understand why you wanted an index entry with "defvar" in it. A reader who will look for "defvar" when they want to find ways of suppressing compiler warnings already knows that defvar is used for that purpose, so why would they use such a topic at Info-index's prompt? That's the opposite of what good index entries should provide -- they should _lead_ to defvar's description as the way to suppress warnings when the reader thinks of "warnings" or some such. > And please either add the same info (about this use of a vacuous > `defvar') to node `Defining Variables' or add a cross-reference from > that node to node `Compiler Errors'. Done.