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#25292: Ambiguity in doc string of defvar Date: Thu, 29 Dec 2016 20:29:15 +0200 Message-ID: <83r34qtwqs.fsf@gnu.org> References: <20161229181838.GB2531@acm.fritz.box> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1483036225 12645 195.159.176.226 (29 Dec 2016 18:30:25 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Thu, 29 Dec 2016 18:30:25 +0000 (UTC) Cc: 25292@debbugs.gnu.org To: Alan Mackenzie Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Dec 29 19:30:18 2016 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 1cMfSr-0001cj-6F for geb-bug-gnu-emacs@m.gmane.org; Thu, 29 Dec 2016 19:30:09 +0100 Original-Received: from localhost ([::1]:36858 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cMfSv-0007ou-SK for geb-bug-gnu-emacs@m.gmane.org; Thu, 29 Dec 2016 13:30:13 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49096) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cMfSq-0007nc-IS for bug-gnu-emacs@gnu.org; Thu, 29 Dec 2016 13:30:09 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cMfSm-0003Nh-Jp for bug-gnu-emacs@gnu.org; Thu, 29 Dec 2016 13:30:08 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:43985) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cMfSm-0003NO-GH for bug-gnu-emacs@gnu.org; Thu, 29 Dec 2016 13:30:04 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1cMfSk-00012U-SM for bug-gnu-emacs@gnu.org; Thu, 29 Dec 2016 13:30:04 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 29 Dec 2016 18:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25292 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 25292-submit@debbugs.gnu.org id=B25292.14830361753936 (code B ref 25292); Thu, 29 Dec 2016 18:30:02 +0000 Original-Received: (at 25292) by debbugs.gnu.org; 29 Dec 2016 18:29:35 +0000 Original-Received: from localhost ([127.0.0.1]:59384 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cMfSI-00011Q-Pf for submit@debbugs.gnu.org; Thu, 29 Dec 2016 13:29:34 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:57923) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cMfSG-00011D-BH for 25292@debbugs.gnu.org; Thu, 29 Dec 2016 13:29:34 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cMfS7-0002c6-B5 for 25292@debbugs.gnu.org; Thu, 29 Dec 2016 13:29:27 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:56726) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cMfS7-0002bt-7w; Thu, 29 Dec 2016 13:29:23 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:1404 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1cMfS5-00062b-Tz; Thu, 29 Dec 2016 13:29:22 -0500 In-reply-to: <20161229181838.GB2531@acm.fritz.box> (message from Alan Mackenzie on Thu, 29 Dec 2016 18:18:38 +0000) 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:127556 Archived-At: > Date: Thu, 29 Dec 2016 18:18:38 +0000 > From: Alan Mackenzie > > INITVALUE is evaluated, and if SYMBOL's value is void, it is used to > set SYMBOL. ^^ That "it" is ambiguous. By default, people tend to interpret "it" as referring to the last noun before it, but that's not what you mean in this case. And after all that, are you sure INITVALUE is always evaluated?