From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#11040: 24.0.94; doc string of `indirect-variable' Date: Sun, 18 Mar 2012 09:36:52 -0700 Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1332088665 21761 80.91.229.3 (18 Mar 2012 16:37:45 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 18 Mar 2012 16:37:45 +0000 (UTC) To: 11040@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Mar 18 17:37:44 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1S9J71-0000ot-6W for geb-bug-gnu-emacs@m.gmane.org; Sun, 18 Mar 2012 17:37:43 +0100 Original-Received: from localhost ([::1]:48270 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S9J70-000273-DY for geb-bug-gnu-emacs@m.gmane.org; Sun, 18 Mar 2012 12:37:42 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:32825) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S9J6x-00026s-Vn for bug-gnu-emacs@gnu.org; Sun, 18 Mar 2012 12:37:41 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1S9J6w-0000tG-9K for bug-gnu-emacs@gnu.org; Sun, 18 Mar 2012 12:37:39 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:48983) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S9J6w-0000t8-5V for bug-gnu-emacs@gnu.org; Sun, 18 Mar 2012 12:37:38 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1S9JaM-0002GI-Mj for bug-gnu-emacs@gnu.org; Sun, 18 Mar 2012 13:08:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 18 Mar 2012 17:08:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 11040 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.13320904688652 (code B ref -1); Sun, 18 Mar 2012 17:08:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 18 Mar 2012 17:07:48 +0000 Original-Received: from localhost ([127.0.0.1]:55815 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1S9Ja7-0002FS-9W for submit@debbugs.gnu.org; Sun, 18 Mar 2012 13:07:48 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:44305) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1S9JZw-0002Ex-BX for submit@debbugs.gnu.org; Sun, 18 Mar 2012 13:07:46 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1S9J6T-0000i3-Ah for submit@debbugs.gnu.org; Sun, 18 Mar 2012 12:37:10 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:43846) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S9J6T-0000hy-7e for submit@debbugs.gnu.org; Sun, 18 Mar 2012 12:37:09 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:60859) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S9J6R-000253-MI for bug-gnu-emacs@gnu.org; Sun, 18 Mar 2012 12:37:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1S9J6P-0000he-Uh for bug-gnu-emacs@gnu.org; Sun, 18 Mar 2012 12:37:07 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:18526) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1S9J6P-0000gM-Og for bug-gnu-emacs@gnu.org; Sun, 18 Mar 2012 12:37:05 -0400 Original-Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q2IGb2sm031587 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 18 Mar 2012 16:37:03 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q2IGb14n005850 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sun, 18 Mar 2012 16:37:02 GMT Original-Received: from abhmt117.oracle.com (abhmt117.oracle.com [141.146.116.69]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q2IGb1qR001266 for ; Sun, 18 Mar 2012 11:37:01 -0500 Original-Received: from dradamslap1 (/10.159.45.19) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 18 Mar 2012 09:37:01 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac0FJVLF2fM/75anRV2dZ6f5bUcAGA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-CT-RefId: str=0001.0A090202.4F660F2F.0034,ss=1,re=0.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:57875 Archived-At: The doc string, unlike (elisp) `Variable Aliases', is not at all clear. It says nothing about what is meant here by "indirection". This is Lisp. There are several kinds of "indirection" for Lisp variables, including via values and via properties. The manual makes clear what is meant by talking about "aliases", which is the kind of indirection this function is about. Please do similarly for the doc string. To be even clearer, the doc (in both places, but especially the doc string, since the manual node already sets the context) should explicitly mention `defvaralias' when referring to variable aliasing. In GNU Emacs 24.0.94.1 (i386-mingw-nt5.1.2600) of 2012-02-26 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --no-opt --enable-checking --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include'