From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: `interactive-form` symbol property (was: [Emacs-diffs] emacs-26 9a53b6d: Say how to override a primitive interactive spec) Date: Sun, 24 Jun 2018 08:27:51 -0700 (PDT) Message-ID: References: <20180624121111.28772.8847@vcs0.savannah.gnu.org> <20180624121113.215CF206CC@vcs0.savannah.gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1529854000 25526 195.159.176.226 (24 Jun 2018 15:26:40 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 24 Jun 2018 15:26:40 +0000 (UTC) Cc: Karl Fogel To: Stefan Monnier , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jun 24 17:26:36 2018 Return-path: Envelope-to: ged-emacs-devel@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 1fX6uR-0006YQ-UU for ged-emacs-devel@m.gmane.org; Sun, 24 Jun 2018 17:26:36 +0200 Original-Received: from localhost ([::1]:42253 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fX6wX-0006Ef-Ks for ged-emacs-devel@m.gmane.org; Sun, 24 Jun 2018 11:28:45 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54928) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fX6vr-0006EY-No for emacs-devel@gnu.org; Sun, 24 Jun 2018 11:28:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fX6vm-0001iM-Pm for emacs-devel@gnu.org; Sun, 24 Jun 2018 11:28:03 -0400 Original-Received: from userp2120.oracle.com ([156.151.31.85]:60542) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fX6vm-0001h0-GY for emacs-devel@gnu.org; Sun, 24 Jun 2018 11:27:58 -0400 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w5OFRtOH142043; Sun, 24 Jun 2018 15:27:55 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=zb/wSYodUE3e/30uMTsCtB5VEkG9xKnxmuAGk8Q09ic=; b=uRxKNXRbjBnXwYrJ7Ga1FZ9iVi2c7qQ6JJJNhFa3lbI6/DAk5h1f1C7wNKqOL6ZMUBcA kO2/oc+8TO/AE9vDZcnKAiF8WMIKuWhZOSTP3O9T7wMAZpE0t/W7Yogv8w2snbbsIOB5 L8Ll48M9QzgYcCINESGZx0QePJrTbMvSC0buEGAV0uUt15NK5fMp3TMWx9huGv05Wr5T 76jdhD1i1POdlyY3JdNyQEFKFvibBYpTg67I16o+pTCXDA52wQQPIt1HBNZAics+q9Bi UVsLaqvBjp3aim5Fa9Lo0nJQmpgGhKov51xjg9QgbCxSL4f/NNiScZ7eVnQ1hzCF0IMy bA== Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by userp2120.oracle.com with ESMTP id 2jt8a7g9w0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 24 Jun 2018 15:27:55 +0000 Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id w5OFRsW1029977 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 24 Jun 2018 15:27:54 GMT Original-Received: from abhmp0002.oracle.com (abhmp0002.oracle.com [141.146.116.8]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id w5OFRr9O006226; Sun, 24 Jun 2018 15:27:53 GMT In-Reply-To: X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4705.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8934 signatures=668703 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1806210000 definitions=main-1806240187 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-Received-From: 156.151.31.85 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:226652 Archived-At: > >> +If you wish to override a primitive interactive specification, just > >> +set the @code{interactive-form} property of the primitive function's > >> +symbol (@pxref{Using Interactive}). There is no need to edit C code > >> +and recompile Emacs. > > You can also use advice-add for the same purpose (it's more > > complicated, but it's arguably better behaved). >=20 > And a quick search seems to indicate that this `interactive-form` > property is not used anywhere (not within Emacs, not within GNU ELPA, > and not within the few other Elisp packages I had lying around for > a quick search). >=20 > Maybe, rather than document it, we should obsolete it? Why? Is the existence of this property causing some problem? Seems like it could be useful (and simple to use) in code generation or manipulation. You can't advise a function that doesn't exist yet. (To be clear, I haven't used this property. I have used the function of the same name, however.) --- BTW, in the Elisp manual we have 2 index entries for this, with pretty much the same text (shared prefix) and different targets. If we want two entries, for the different targets, perhaps the entries should not be so similar? * interactive-form property: Defining Commands. (line 16) * interactive-form, symbol property: Using Interactive. (line 21) There is even a third entry, which might appear to fall into the same boat, but it in fact refers to the function of the same name: * interactive-form: Using Interactive. (line 129) If we want to distinguish function from property in the index entries, then perhaps the function entry should be something like `interactive-form, function'.