Mercurial > hg > xemacs-beta
diff src/macros.c @ 428:3ecd8885ac67 r21-2-22
Import from CVS: tag r21-2-22
author | cvs |
---|---|
date | Mon, 13 Aug 2007 11:28:15 +0200 |
parents | |
children | 576fb035e263 |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/macros.c Mon Aug 13 11:28:15 2007 +0200 @@ -0,0 +1,332 @@ +/* Keyboard macros. + Copyright (C) 1985, 1986, 1992, 1993, 1994 Free Software Foundation, Inc. + +This file is part of XEmacs. + +XEmacs is free software; you can redistribute it and/or modify it +under the terms of the GNU General Public License as published by the +Free Software Foundation; either version 2, or (at your option) any +later version. + +XEmacs is distributed in the hope that it will be useful, but WITHOUT +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License +for more details. + +You should have received a copy of the GNU General Public License +along with XEmacs; see the file COPYING. If not, write to +the Free Software Foundation, Inc., 59 Temple Place - Suite 330, +Boston, MA 02111-1307, USA. */ + +/* Synched up with: FSF 19.30. */ + +/* A keyboard macro is a string of ASCII characters, or a vector of event + objects. Only key-press, mouse-press, mouse-release, and menu-selection + events ever get into a keyboard macro. + + When interactively defining a keyboard macro, it will always be a vector + of events; strings may be executed for backwards compatibility. + */ + +#include <config.h> +#include "lisp.h" +#include "events.h" +#include "macros.h" +#include "commands.h" +#include "console.h" +#include "buffer.h" +#include "window.h" +#include "frame.h" +#include "keymap.h" + +Lisp_Object Qexecute_kbd_macro; + +/* The current macro and our position in it. When executing nested kbd + macros, previous values for these are wound through the execution stack + with unwind-protect. + */ +Lisp_Object Vexecuting_macro; +int executing_macro_index; + + +DEFUN ("start-kbd-macro", Fstart_kbd_macro, 1, 1, "P", /* +Record subsequent keyboard and menu input, defining a keyboard macro. +The commands are recorded even as they are executed. +Use \\[end-kbd-macro] to finish recording and make the macro available. +Use \\[name-last-kbd-macro] to give it a permanent name. +Non-nil arg (prefix arg) means append to last macro defined; + This begins by re-executing that macro as if you typed it again. +*/ + (append)) +{ + /* This function can GC */ + struct console *con = XCONSOLE (Vselected_console); + if (!NILP (con->defining_kbd_macro)) + error ("Already defining kbd macro"); + + if (NILP (con->kbd_macro_builder)) + con->kbd_macro_builder = make_vector (30, Qnil); + + zmacs_region_stays = 1; /* set this before calling Fexecute_kbd_macro() + so that functions there can override */ + MARK_MODELINE_CHANGED; + if (NILP (append)) + { + con->kbd_macro_ptr = 0; + con->kbd_macro_end = 0; + message ("Defining kbd macro..."); + } + else + { + message ("Appending to kbd macro..."); + con->kbd_macro_ptr = con->kbd_macro_end; + Fexecute_kbd_macro (con->last_kbd_macro, make_int (1)); + } + con->defining_kbd_macro = Qt; + + return Qnil; +} + +DEFUN ("end-kbd-macro", Fend_kbd_macro, 0, 1, "P", /* +Finish defining a keyboard macro. +The definition was started by \\[start-kbd-macro]. +The macro is now available for use via \\[call-last-kbd-macro], +or it can be given a name with \\[name-last-kbd-macro] and then invoked +under that name. + +With numeric arg, repeat macro now that many times, +counting the definition just completed as the first repetition. +An argument of zero means repeat until error. +*/ + (arg)) +{ + /* This function can GC */ + struct console *con = XCONSOLE (Vselected_console); + int repeat; + + if (NILP (con->defining_kbd_macro)) + error ("Not defining kbd macro"); + + if (NILP (arg)) + repeat = -1; + else + repeat = XINT (Fprefix_numeric_value (arg)); + + if (!NILP (con->defining_kbd_macro)) + { + int i; + int size = con->kbd_macro_end; + + if (size < 0) + size = 0; + con->last_kbd_macro = make_vector (size, Qnil); + for (i = 0; i < size; i++) + XVECTOR_DATA (con->last_kbd_macro) [i] = + XVECTOR_DATA (con->kbd_macro_builder) [i]; + con->defining_kbd_macro = Qnil; + MARK_MODELINE_CHANGED; + message ("Keyboard macro defined"); + } + + zmacs_region_stays = 1; /* set this before calling Fexecute_kbd_macro() + so that functions there can override */ + if (repeat < 0) + return Qnil; + else if (repeat == 0) + return Fexecute_kbd_macro (con->last_kbd_macro, Qzero); + else + return Fexecute_kbd_macro (con->last_kbd_macro, + make_int (repeat - 1)); +} + +/* #### Read the comment in modeline.el to see why this ugliness is + needed. #### Try to avoid it, somehow! */ +DEFUN ("zap-last-kbd-macro-event", Fzap_last_kbd_macro_event, 0, 0, 0, /* +Don't look at this lest you vomit or spontaneously combust. +*/ + ()) +{ + struct console *con = XCONSOLE (Vselected_console); + if (con->kbd_macro_end) + --con->kbd_macro_end; + return Qnil; +} + +/* Store event into kbd macro being defined + */ +void +store_kbd_macro_event (Lisp_Object event) +{ + struct console *con = event_console_or_selected (event); + + if (con->kbd_macro_ptr == XVECTOR_LENGTH (con->kbd_macro_builder)) + { + int i; + int old_size = XVECTOR_LENGTH (con->kbd_macro_builder); + int new_size = old_size * 2; + Lisp_Object new = make_vector (new_size, Qnil); + for (i = 0; i < old_size; i++) + XVECTOR_DATA (new) [i] = XVECTOR_DATA (con->kbd_macro_builder) [i]; + con->kbd_macro_builder = new; + } + XVECTOR_DATA (con->kbd_macro_builder) [con->kbd_macro_ptr++] = + Fcopy_event (event, Qnil); +} + +/* Extract the next kbd-macro element into the given event. + If we're done, throws to the catch in Fexecute_kbd_macro(). + */ +void +pop_kbd_macro_event (Lisp_Object event) +{ + if (NILP (Vexecuting_macro)) abort (); + + if (STRINGP (Vexecuting_macro) || VECTORP (Vexecuting_macro)) + { + if (executing_macro_index < XINT (Flength (Vexecuting_macro))) + { + nth_of_key_sequence_as_event (Vexecuting_macro, + executing_macro_index++, + event); + return; + } + } + else if (!EQ (Vexecuting_macro, Qt)) /* Some things replace the macro + with Qt to force an early exit. */ + error ("junk in executing-macro"); + + Fthrow (Qexecute_kbd_macro, Qt); +} + + +/* Declare that all chars stored so far in the kbd macro being defined + really belong to it. This is done in between editor commands. */ + +void +finalize_kbd_macro_chars (struct console *con) +{ + con->kbd_macro_end = con->kbd_macro_ptr; +} + +DEFUN ("cancel-kbd-macro-events", Fcancel_kbd_macro_events, 0, 0, 0, /* +Cancel the events added to a keyboard macro for this command. +*/ + ()) +{ + struct console *con = XCONSOLE (Vselected_console); + + con->kbd_macro_ptr = con->kbd_macro_end; + + return Qnil; +} + +DEFUN ("call-last-kbd-macro", Fcall_last_kbd_macro, 0, 1, "p", /* +Call the last keyboard macro that you defined with \\[start-kbd-macro]. + +A prefix argument serves as a repeat count. Zero means repeat until error. + +To make a macro permanent so you can call it even after +defining others, use \\[name-last-kbd-macro]. +*/ + (prefix)) +{ + /* This function can GC */ + struct console *con = XCONSOLE (Vselected_console); + + if (!NILP (con->defining_kbd_macro)) + error ("Can't execute anonymous macro while defining one"); + else if (NILP (con->last_kbd_macro)) + error ("No kbd macro has been defined"); + else + Fexecute_kbd_macro (con->last_kbd_macro, prefix); + return Qnil; +} + +/* Restore Vexecuting_macro and executing_macro_index - called when + the unwind-protect in Fexecute_kbd_macro gets invoked. */ +static Lisp_Object +pop_kbd_macro (Lisp_Object info) +{ + Vexecuting_macro = Fcar (info); + executing_macro_index = XINT (Fcdr (info)); + return Qnil; +} + +DEFUN ("execute-kbd-macro", Fexecute_kbd_macro, 1, 2, 0, /* +Execute MACRO as string of editor command characters. +If MACRO is a symbol, its function definition is used. +COUNT is a repeat count, or nil for once, or 0 for infinite loop. +*/ + (macro, prefixarg)) +{ + /* This function can GC */ + Lisp_Object final; + Lisp_Object tem; + int speccount = specpdl_depth (); + int repeat = 1; + struct gcpro gcpro1; + struct console *con = XCONSOLE (Vselected_console); + + if (!NILP (prefixarg)) + { + prefixarg = Fprefix_numeric_value (prefixarg); + repeat = XINT (prefixarg); + } + + final = indirect_function (macro, 1); + if (!STRINGP (final) && !VECTORP (final)) + error ("Keyboard macros must be strings or vectors"); + + tem = Fcons (Vexecuting_macro, make_int (executing_macro_index)); + record_unwind_protect (pop_kbd_macro, tem); + + GCPRO1 (final); + do + { + Vexecuting_macro = final; + executing_macro_index = 0; + con->prefix_arg = Qnil; + internal_catch (Qexecute_kbd_macro, call_command_loop, + Qnil, 0); + } + while (--repeat != 0 + && (STRINGP (Vexecuting_macro) || + VECTORP (Vexecuting_macro))); + + UNGCPRO; + return unbind_to (speccount, Qnil); +} + + +void +syms_of_macros (void) +{ + DEFSUBR (Fstart_kbd_macro); + DEFSUBR (Fend_kbd_macro); + DEFSUBR (Fzap_last_kbd_macro_event); + DEFSUBR (Fcall_last_kbd_macro); + DEFSUBR (Fexecute_kbd_macro); + DEFSUBR (Fcancel_kbd_macro_events); + defsymbol (&Qexecute_kbd_macro, "execute-kbd-macro"); +} + +void +vars_of_macros (void) +{ + DEFVAR_LISP ("executing-macro", &Vexecuting_macro /* +Currently executing keyboard macro (a vector of events or string); +nil if none executing. +*/ ); + + DEFVAR_LISP ("executing-kbd-macro", &Vexecuting_macro /* +Currently executing keyboard macro (a vector of events or string); +nil if none executing. +*/ ); +} + +void +init_macros (void) +{ + Vexecuting_macro = Qnil; +} +