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#13343: 24.3.50; give examples using `gv-define-expander' and `gv-letplace' Date: Wed, 2 Jan 2013 15:52:35 -0800 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: ger.gmane.org 1357170827 10042 80.91.229.3 (2 Jan 2013 23:53:47 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 2 Jan 2013 23:53:47 +0000 (UTC) To: 13343@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jan 03 00:54:04 2013 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 1TqY8E-0006W4-EE for geb-bug-gnu-emacs@m.gmane.org; Thu, 03 Jan 2013 00:53:58 +0100 Original-Received: from localhost ([::1]:33355 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TqY7z-00020F-G5 for geb-bug-gnu-emacs@m.gmane.org; Wed, 02 Jan 2013 18:53:43 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:46109) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TqY7w-000205-CH for bug-gnu-emacs@gnu.org; Wed, 02 Jan 2013 18:53:41 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TqY7v-0000Kc-8B for bug-gnu-emacs@gnu.org; Wed, 02 Jan 2013 18:53:40 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:58520) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TqY7v-0000KT-4w for bug-gnu-emacs@gnu.org; Wed, 02 Jan 2013 18:53:39 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TqY9G-0001Y8-Aj for bug-gnu-emacs@gnu.org; Wed, 02 Jan 2013 18:55:02 -0500 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: Wed, 02 Jan 2013 23:55:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 13343 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.13571708575886 (code B ref -1); Wed, 02 Jan 2013 23:55:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 2 Jan 2013 23:54:17 +0000 Original-Received: from localhost ([127.0.0.1]:40538 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TqY8U-0001Wq-L9 for submit@debbugs.gnu.org; Wed, 02 Jan 2013 18:54:17 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:34513) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TqY8O-0001Wc-5E for submit@debbugs.gnu.org; Wed, 02 Jan 2013 18:54:12 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TqY71-0000Aw-Lm for submit@debbugs.gnu.org; Wed, 02 Jan 2013 18:52:44 -0500 Original-Received: from lists.gnu.org ([208.118.235.17]:41914) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TqY71-0000Ar-IV for submit@debbugs.gnu.org; Wed, 02 Jan 2013 18:52:43 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:45862) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TqY6z-0001Ns-I6 for bug-gnu-emacs@gnu.org; Wed, 02 Jan 2013 18:52:43 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TqY6y-0000AW-Ec for bug-gnu-emacs@gnu.org; Wed, 02 Jan 2013 18:52:41 -0500 Original-Received: from userp1040.oracle.com ([156.151.31.81]:27751) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TqY6y-0000AJ-7N for bug-gnu-emacs@gnu.org; Wed, 02 Jan 2013 18:52:40 -0500 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by userp1040.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id r02Nqbh7003260 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 2 Jan 2013 23:52:38 GMT Original-Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r02NqbCB015757 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 2 Jan 2013 23:52:37 GMT Original-Received: from abhmt102.oracle.com (abhmt102.oracle.com [141.146.116.54]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id r02NqboC021422 for ; Wed, 2 Jan 2013 17:52:37 -0600 Original-Received: from dradamslap1 (/130.35.178.8) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 02 Jan 2013 15:52:37 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac3pRD0LsRWW2Sq2STKhQ+6qvL3N5A== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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.x 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:69310 Archived-At: (elisp) `Adding Generalized Variables' says only this: For more control over the expansion, see the macro `gv-define-expander'. The macro `gv-letplace' can be useful in defining macros that perform similarly to `setf'; for example, the `incf' macro of Common Lisp. Consult the source file `gv.el' for more details. That's a complete cop-out. Give at least one example of using each of `gv-define-expander' and `gv-letplace'. Telling users to refer to gv.el for information about using these macros is off-base. Neither the commentary in that file nor the doc strings of these two macros help. We should not send users off to analyze the _implementation_ of these macros in order to figure out how to use them to define generalized variables. We should describe what these macros do specifically, and show how to use them. All the current doc says, to describe these macros, is (a) `gv-define-expander' gives you "more control" and (b) `gv-letplace' "can be useful". "See the macro", indeed. See what? It's implementation? Emacs users deserve better. In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600) of 2012-12-31 on ODIEONE Bzr revision: 111388 rudalics@gmx.at-20121231113513-subz2dazg6yjukzh Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -IC:/Devel/emacs/build/include --ldflags -LC:/Devel/emacs/build/lib'