From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Karl Fogel Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] emacs-26 9a53b6d: Say how to override a primitive interactive spec Date: Mon, 25 Jun 2018 07:43:58 -0500 Message-ID: <87r2kvujch.fsf@red-bean.com> References: <20180624121111.28772.8847@vcs0.savannah.gnu.org> <20180624121113.215CF206CC@vcs0.savannah.gnu.org> <83d0wgtfa3.fsf@gnu.org> <87lgb36dlc.fsf@red-bean.com> <83tvprsig4.fsf@gnu.org> Reply-To: Karl Fogel NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1529931911 14899 195.159.176.226 (25 Jun 2018 13:05:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 25 Jun 2018 13:05:11 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1.50 (gnu/linux) Cc: monnier@IRO.UMontreal.CA, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jun 25 15:05:07 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 1fXRB5-0003ln-7M for ged-emacs-devel@m.gmane.org; Mon, 25 Jun 2018 15:05:07 +0200 Original-Received: from localhost ([::1]:46777 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fXRDC-0003tV-B9 for ged-emacs-devel@m.gmane.org; Mon, 25 Jun 2018 09:07:18 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54245) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fXQqg-0001gX-Er for emacs-devel@gnu.org; Mon, 25 Jun 2018 08:44:03 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fXQqf-0007qh-Fr for emacs-devel@gnu.org; Mon, 25 Jun 2018 08:44:02 -0400 Original-Received: from mail-oi0-x242.google.com ([2607:f8b0:4003:c06::242]:33593) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fXQqf-0007qR-AY; Mon, 25 Jun 2018 08:44:01 -0400 Original-Received: by mail-oi0-x242.google.com with SMTP id c6-v6so12343186oiy.0; Mon, 25 Jun 2018 05:44:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:in-reply-to:references:references :reply-to:date:message-id:user-agent:mime-version; bh=6L5XoCCUe87nZR0XPiI7CTeXpy7t+v/w9zmPbt4fJC0=; b=Gjh2fc9tqd4f4XxTEsIxMqe4633JWrcG9MCgRznKjCbW/QYe8xZLaOxtmmG+sdIyh3 obI5jjHr/9bK8PLbNg4qCq55dr1RV51OzQSly49JLJV9YH57vVEq4osc7Rj7EaRml8k6 17I3gc49rtCIYWIEBEq7Ac07Z+E9389hDJtlj+C8YNpYnrrNoP1ty9jIBQXJMjOQcbEK ildPxtK1GbiuVp5R1NmhQLSfAz2d48i0p/AuJ5X0Ki7rmz4QtjPnHecVhov/fFVDQiq1 D06mnIiKLW6BuXmEHISL7YdFd3tDffF/9d30z+zbtfyQcN4l86WUJX8f059t0ecrU6gi 8cog== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:in-reply-to:references :references:reply-to:date:message-id:user-agent:mime-version; bh=6L5XoCCUe87nZR0XPiI7CTeXpy7t+v/w9zmPbt4fJC0=; b=n/s6FEoA4ylm+Oojz8RNY0PXlxJE0SYVxZBWcU0UogFdtK08IEIHdH8Sc1I7vEi8ad SI9964kUnpS3H/lCJjQCX+olYnvEP+AC+SIYpkYTDlCv6JM5BRvSry2r+tL/mNxnsTEH S4BgkFU0l8SfBcx9rnFoH3aasBovJlitmt+RTok3EeDIKjqKGh1Zm7cJouZGm9XC8V1V iwCVpW+km9wTFpSBopybJ41WxnlIiMK7iCQpjIde1BCJfJZ6+LENhKTgR0Vinq0BJVZP f//oSwk55i00CNVM4c0iZiyxMPC43i5y7Zn06dxFFzj5VpJRTZU0haCjDOgd71Q2lzGL plTA== X-Gm-Message-State: APt69E29Jx6JQbZqiPkREr/Qb3fcdZm7wIO9gQA4QooPH8Ub/htu6/41 2udV062EdYXBagRjEOIb/ihNMA== X-Google-Smtp-Source: ADUXVKIgRY/bT9m5QLs1M8X3Xp113TueMciFsBbcwAh3mfcvaM3x4glzVrUQRKumktZYcrm7/AKSEw== X-Received: by 2002:aca:2808:: with SMTP id 8-v6mr7210615oix.235.1529930640229; Mon, 25 Jun 2018 05:44:00 -0700 (PDT) Original-Received: from floss ([2602:306:3707:da30:bccb:fed9:2216:e3f2]) by smtp.gmail.com with ESMTPSA id w5-v6sm7014248otg.5.2018.06.25.05.43.58 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 25 Jun 2018 05:43:59 -0700 (PDT) In-Reply-To: <87y3f3a5o9.fsf@red-bean.com> Original-References: <20180624121111.28772.8847@vcs0.savannah.gnu.org> <20180624121113.215CF206CC@vcs0.savannah.gnu.org> <83d0wgtfa3.fsf@gnu.org> <87lgb36dlc.fsf@red-bean.com> <83tvprsig4.fsf@gnu.org> <87y3f3a5o9.fsf@red-bean.com> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:4003:c06::242 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:226703 Archived-At: I wrote: >One route might be to just put a "(@pxref{Using interactive})" at the >end of the sentence [...] instead of my larger change, which I'd be >happy to do; maybe that's the kind of thing you had mind by >"cross-reference" in the first place. Slept on it and realized that's a better solution (and also likely what you originally meant). Eli, if this looks like a good doc patch to you I'll install it: --- doc/lispref/internals.texi +++ doc/lispref/internals.texi @@ -726,7 +726,8 @@ Writing Emacs Primitives @cindex interactive specification in primitives @item interactive This is an interactive specification, a string such as might be used -as the argument of @code{interactive} in a Lisp function. In the case +as the argument of @code{interactive} in a Lisp function +(@pxref{Using Interactive}). In the case of @code{or}, it is 0 (a null pointer), indicating that @code{or} cannot be called interactively. A value of @code{""} indicates a function that should receive no arguments when called interactively. @@ -743,11 +744,6 @@ Writing Emacs Primitives @end group @end example -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. - @item doc This is the documentation string. It uses C comment syntax rather than C string syntax because comment syntax requires nothing special