From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#13800: 24.3.50; About an example in "(elisp) Writing Emacs Primitives" Date: Sun, 24 Feb 2013 17:05:09 +0200 Message-ID: <83obf9kb16.fsf@gnu.org> References: <20130224145548.19f7704b99f913667ab3e4bb@gmail.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1361718402 8469 80.91.229.3 (24 Feb 2013 15:06:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 24 Feb 2013 15:06:42 +0000 (UTC) Cc: 13800@debbugs.gnu.org To: Xue Fuqiao Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Feb 24 16:07: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 1U9dAK-0004Nl-I4 for geb-bug-gnu-emacs@m.gmane.org; Sun, 24 Feb 2013 16:07:00 +0100 Original-Received: from localhost ([::1]:49337 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U9d9z-0003vi-U2 for geb-bug-gnu-emacs@m.gmane.org; Sun, 24 Feb 2013 10:06:39 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:38425) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U9d9r-0003vP-0g for bug-gnu-emacs@gnu.org; Sun, 24 Feb 2013 10:06:38 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1U9d9o-0000SR-76 for bug-gnu-emacs@gnu.org; Sun, 24 Feb 2013 10:06:30 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:42185) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U9d9o-0000S8-25 for bug-gnu-emacs@gnu.org; Sun, 24 Feb 2013 10:06:28 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1U9dBJ-0005gG-Iw for bug-gnu-emacs@gnu.org; Sun, 24 Feb 2013 10:08:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 24 Feb 2013 15:08:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 13800 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 13800-submit@debbugs.gnu.org id=B13800.136171846721816 (code B ref 13800); Sun, 24 Feb 2013 15:08:01 +0000 Original-Received: (at 13800) by debbugs.gnu.org; 24 Feb 2013 15:07:47 +0000 Original-Received: from localhost ([127.0.0.1]:47649 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9dB5-0005fp-Dp for submit@debbugs.gnu.org; Sun, 24 Feb 2013 10:07:47 -0500 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:61113) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1U9dAx-0005fX-U5 for 13800@debbugs.gnu.org; Sun, 24 Feb 2013 10:07:44 -0500 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0MIQ00E00CITKS00@a-mtaout22.012.net.il> for 13800@debbugs.gnu.org; Sun, 24 Feb 2013 17:05:19 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MIQ00E40CKVKP10@a-mtaout22.012.net.il>; Sun, 24 Feb 2013 17:05:19 +0200 (IST) In-reply-to: <20130224145548.19f7704b99f913667ab3e4bb@gmail.com> X-012-Sender: halo1@inter.net.il 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:71745 Archived-At: > Date: Sun, 24 Feb 2013 14:55:48 +0800 > From: Xue Fuqiao > > > In (info "(elisp) Writing Emacs Primitives"): > > INTERACTIVE > This is an interactive specification, a string such as might be > used as the argument of `interactive' in a Lisp function. In the > case of `or', it is 0 (a null pointer), indicating that `or' > cannot be called interactively. A value of `""' indicates a > function that should receive no arguments when called > interactively. If the value begins with a `(', the string is > evaluated as a Lisp form. For examples of the last two forms, see > `widen' and `narrow-to-region' in `editfns.c'. > > In the last sentence, neither the INTERACTIVE of the example primitive > `widen' nor `narrow-to-region' begins with a `('. I think > `narrow-to-region' should be replaced by primitives like `insert-char' > instead. And then, a few years later, someone else will say that the same happened with insert-char, yes? I'd rather suggest to remove any references to the sources, as that is a source of constant maintenance pains and inaccuracies in the docs. Instead, I suggest to add to the manual an example of such a DEFUN declaration.