From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: defining-kbd-macro Date: Thu, 4 Nov 2004 19:22:26 -0600 (CST) Message-ID: <200411050122.iA51MQp21549@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1099617860 4564 80.91.229.6 (5 Nov 2004 01:24:20 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 5 Nov 2004 01:24:20 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 05 02:24:06 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CPspi-0008Mz-00 for ; Fri, 05 Nov 2004 02:24:06 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CPsxs-00028N-T9 for ged-emacs-devel@m.gmane.org; Thu, 04 Nov 2004 20:32:32 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CPsxk-00028I-DN for emacs-devel@gnu.org; Thu, 04 Nov 2004 20:32:24 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CPsxj-000286-MG for emacs-devel@gnu.org; Thu, 04 Nov 2004 20:32:23 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CPsxj-000283-HY for emacs-devel@gnu.org; Thu, 04 Nov 2004 20:32:23 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CPsoa-00084n-4N for emacs-devel@gnu.org; Thu, 04 Nov 2004 20:22:56 -0500 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id iA51MoFu003320 for ; Thu, 4 Nov 2004 19:22:50 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.7p1+Sun/8.11.7) id iA51MQp21549; Thu, 4 Nov 2004 19:22:26 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: emacs-devel@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:29450 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:29450 The value `append' for `defining-kbd-macro' has recently been given a special meaning. I propose the following updates to the docstring and Elisp documentation of `defining-kbd-macro'. I can install if it looks OK. ===File ~/commands.texi-diff================================ *** commands.texi 01 Nov 2004 07:02:18 -0600 1.59 --- commands.texi 04 Nov 2004 19:02:11 -0600 *************** *** 3023,3031 **** @defvar defining-kbd-macro This variable is non-@code{nil} if and only if a keyboard macro is being defined. A command can test this variable so as to behave ! differently while a macro is being defined. The commands ! @code{start-kbd-macro} and @code{end-kbd-macro} set this variable---do ! not set it yourself. The variable is always local to the current terminal and cannot be buffer-local. @xref{Multiple Displays}. --- 3023,3032 ---- @defvar defining-kbd-macro This variable is non-@code{nil} if and only if a keyboard macro is being defined. A command can test this variable so as to behave ! differently while a macro is being defined. The value is ! @code{append} while appending to the definition of an existing macro. ! The commands @code{start-kbd-macro}, @code{kmacro-start-macro} and ! @code{end-kbd-macro} set this variable---do not set it yourself. The variable is always local to the current terminal and cannot be buffer-local. @xref{Multiple Displays}. ============================================================ ===File ~/macros.c-diff===================================== *** macros.c 02 Sep 2003 08:17:58 -0500 1.54 --- macros.c 04 Nov 2004 18:55:43 -0600 *************** *** 392,398 **** defsubr (&Sstore_kbd_macro_event); DEFVAR_KBOARD ("defining-kbd-macro", defining_kbd_macro, ! doc: /* Non-nil while a keyboard macro is being defined. Don't set this! */); DEFVAR_LISP ("executing-macro", &Vexecuting_macro, doc: /* Currently executing keyboard macro (string or vector); nil if none executing. */); --- 392,399 ---- defsubr (&Sstore_kbd_macro_event); DEFVAR_KBOARD ("defining-kbd-macro", defining_kbd_macro, ! doc: /* Non-nil while a keyboard macro is being defined. Don't set this! ! The value is `append' while appending to the definition of an existing macro. */); DEFVAR_LISP ("executing-macro", &Vexecuting_macro, doc: /* Currently executing keyboard macro (string or vector); nil if none executing. */); ============================================================