Merge from trunk
[emacs.git] / src / cmds.c
blobf12e759b7a6573a5f1a6a47e26a2b8058e84f47a
1 /* Simple built-in editing commands.
2 Copyright (C) 1985, 1993, 1994, 1995, 1996, 1997, 1998, 2001, 2002,
3 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
4 Free Software Foundation, Inc.
6 This file is part of GNU Emacs.
8 GNU Emacs is free software: you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 GNU Emacs is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
22 #include <config.h>
23 #include <setjmp.h>
24 #include "lisp.h"
25 #include "commands.h"
26 #include "buffer.h"
27 #include "character.h"
28 #include "syntax.h"
29 #include "window.h"
30 #include "keyboard.h"
31 #include "keymap.h"
32 #include "dispextern.h"
33 #include "frame.h"
35 Lisp_Object Qkill_forward_chars, Qkill_backward_chars;
37 /* A possible value for a buffer's overwrite-mode variable. */
38 Lisp_Object Qoverwrite_mode_binary;
40 static int internal_self_insert (int, int);
42 DEFUN ("forward-point", Fforward_point, Sforward_point, 1, 1, 0,
43 doc: /* Return buffer position N characters after (before if N negative) point. */)
44 (Lisp_Object n)
46 CHECK_NUMBER (n);
48 return make_number (PT + XINT (n));
51 DEFUN ("forward-char", Fforward_char, Sforward_char, 0, 1, "^p",
52 doc: /* Move point N characters forward (backward if N is negative).
53 On reaching end or beginning of buffer, stop and signal error.
55 Depending on the bidirectional context, the movement may be to the
56 right or to the left on the screen. This is in contrast with
57 \\[right-char], which see. */)
58 (Lisp_Object n)
60 if (NILP (n))
61 XSETFASTINT (n, 1);
62 else
63 CHECK_NUMBER (n);
65 /* This used to just set point to point + XINT (n), and then check
66 to see if it was within boundaries. But now that SET_PT can
67 potentially do a lot of stuff (calling entering and exiting
68 hooks, etcetera), that's not a good approach. So we validate the
69 proposed position, then set point. */
71 int new_point = PT + XINT (n);
73 if (new_point < BEGV)
75 SET_PT (BEGV);
76 xsignal0 (Qbeginning_of_buffer);
78 if (new_point > ZV)
80 SET_PT (ZV);
81 xsignal0 (Qend_of_buffer);
84 SET_PT (new_point);
87 return Qnil;
90 DEFUN ("backward-char", Fbackward_char, Sbackward_char, 0, 1, "^p",
91 doc: /* Move point N characters backward (forward if N is negative).
92 On attempt to pass beginning or end of buffer, stop and signal error.
94 Depending on the bidirectional context, the movement may be to the
95 right or to the left on the screen. This is in contrast with
96 \\[left-char], which see. */)
97 (Lisp_Object n)
99 if (NILP (n))
100 XSETFASTINT (n, 1);
101 else
102 CHECK_NUMBER (n);
104 XSETINT (n, - XINT (n));
105 return Fforward_char (n);
108 DEFUN ("forward-line", Fforward_line, Sforward_line, 0, 1, "^p",
109 doc: /* Move N lines forward (backward if N is negative).
110 Precisely, if point is on line I, move to the start of line I + N
111 \("start of line" in the logical order).
112 If there isn't room, go as far as possible (no error).
113 Returns the count of lines left to move. If moving forward,
114 that is N - number of lines moved; if backward, N + number moved.
115 With positive N, a non-empty line at the end counts as one line
116 successfully moved (for the return value). */)
117 (Lisp_Object n)
119 int opoint = PT, opoint_byte = PT_BYTE;
120 int pos, pos_byte;
121 int count, shortage;
123 if (NILP (n))
124 count = 1;
125 else
127 CHECK_NUMBER (n);
128 count = XINT (n);
131 if (count <= 0)
132 shortage = scan_newline (PT, PT_BYTE, BEGV, BEGV_BYTE, count - 1, 1);
133 else
134 shortage = scan_newline (PT, PT_BYTE, ZV, ZV_BYTE, count, 1);
136 /* Since scan_newline does TEMP_SET_PT_BOTH,
137 and we want to set PT "for real",
138 go back to the old point and then come back here. */
139 pos = PT;
140 pos_byte = PT_BYTE;
141 TEMP_SET_PT_BOTH (opoint, opoint_byte);
142 SET_PT_BOTH (pos, pos_byte);
144 if (shortage > 0
145 && (count <= 0
146 || (ZV > BEGV
147 && PT != opoint
148 && (FETCH_BYTE (PT_BYTE - 1) != '\n'))))
149 shortage--;
151 return make_number (count <= 0 ? - shortage : shortage);
154 DEFUN ("beginning-of-line", Fbeginning_of_line, Sbeginning_of_line, 0, 1, "^p",
155 doc: /* Move point to beginning of current line (in the logical order).
156 With argument N not nil or 1, move forward N - 1 lines first.
157 If point reaches the beginning or end of buffer, it stops there.
159 This function constrains point to the current field unless this moves
160 point to a different line than the original, unconstrained result.
161 If N is nil or 1, and a front-sticky field starts at point, the point
162 does not move. To ignore field boundaries bind
163 `inhibit-field-text-motion' to t, or use the `forward-line' function
164 instead. For instance, `(forward-line 0)' does the same thing as
165 `(beginning-of-line)', except that it ignores field boundaries. */)
166 (Lisp_Object n)
168 if (NILP (n))
169 XSETFASTINT (n, 1);
170 else
171 CHECK_NUMBER (n);
173 SET_PT (XINT (Fline_beginning_position (n)));
175 return Qnil;
178 DEFUN ("end-of-line", Fend_of_line, Send_of_line, 0, 1, "^p",
179 doc: /* Move point to end of current line (in the logical order).
180 With argument N not nil or 1, move forward N - 1 lines first.
181 If point reaches the beginning or end of buffer, it stops there.
182 To ignore intangibility, bind `inhibit-point-motion-hooks' to t.
184 This function constrains point to the current field unless this moves
185 point to a different line than the original, unconstrained result. If
186 N is nil or 1, and a rear-sticky field ends at point, the point does
187 not move. To ignore field boundaries bind `inhibit-field-text-motion'
188 to t. */)
189 (Lisp_Object n)
191 int newpos;
193 if (NILP (n))
194 XSETFASTINT (n, 1);
195 else
196 CHECK_NUMBER (n);
198 while (1)
200 newpos = XINT (Fline_end_position (n));
201 SET_PT (newpos);
203 if (PT > newpos
204 && FETCH_CHAR (PT - 1) == '\n')
206 /* If we skipped over a newline that follows
207 an invisible intangible run,
208 move back to the last tangible position
209 within the line. */
211 SET_PT (PT - 1);
212 break;
214 else if (PT > newpos && PT < ZV
215 && FETCH_CHAR (PT) != '\n')
216 /* If we skipped something intangible
217 and now we're not really at eol,
218 keep going. */
219 n = make_number (1);
220 else
221 break;
224 return Qnil;
227 DEFUN ("delete-char", Fdelete_char, Sdelete_char, 1, 2, "p\nP",
228 doc: /* Delete the following N characters (previous if N is negative).
229 Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).
230 Interactively, N is the prefix arg, and KILLFLAG is set if
231 N was explicitly specified.
233 The command `delete-forward' is preferable for interactive use. */)
234 (Lisp_Object n, Lisp_Object killflag)
236 int pos;
238 CHECK_NUMBER (n);
240 pos = PT + XINT (n);
241 if (NILP (killflag))
243 if (XINT (n) < 0)
245 if (pos < BEGV)
246 xsignal0 (Qbeginning_of_buffer);
247 else
248 del_range (pos, PT);
250 else
252 if (pos > ZV)
253 xsignal0 (Qend_of_buffer);
254 else
255 del_range (PT, pos);
258 else
260 call1 (Qkill_forward_chars, n);
262 return Qnil;
265 static int nonundocount;
267 /* Note that there's code in command_loop_1 which typically avoids
268 calling this. */
269 DEFUN ("self-insert-command", Fself_insert_command, Sself_insert_command, 1, 1, "p",
270 doc: /* Insert the character you type.
271 Whichever character you type to run this command is inserted.
272 Before insertion, `expand-abbrev' is executed if the inserted character does
273 not have word syntax and the previous character in the buffer does.
274 After insertion, the value of `auto-fill-function' is called if the
275 `auto-fill-chars' table has a non-nil value for the inserted character. */)
276 (Lisp_Object n)
278 int remove_boundary = 1;
279 CHECK_NUMBER (n);
281 if (!EQ (Vthis_command, current_kboard->Vlast_command))
282 nonundocount = 0;
284 if (NILP (Vexecuting_kbd_macro)
285 && !EQ (minibuf_window, selected_window))
287 if (nonundocount <= 0 || nonundocount >= 20)
289 remove_boundary = 0;
290 nonundocount = 0;
292 nonundocount++;
295 if (remove_boundary
296 && CONSP (current_buffer->undo_list)
297 && NILP (XCAR (current_buffer->undo_list)))
298 /* Remove the undo_boundary that was just pushed. */
299 current_buffer->undo_list = XCDR (current_buffer->undo_list);
301 /* Barf if the key that invoked this was not a character. */
302 if (!CHARACTERP (last_command_event))
303 bitch_at_user ();
305 int character = translate_char (Vtranslation_table_for_input,
306 XINT (last_command_event));
307 int val = internal_self_insert (character, XFASTINT (n));
308 if (val == 2)
309 nonundocount = 0;
310 frame_make_pointer_invisible ();
313 return Qnil;
316 /* Insert N times character C
318 If this insertion is suitable for direct output (completely simple),
319 return 0. A value of 1 indicates this *might* not have been simple.
320 A value of 2 means this did things that call for an undo boundary. */
322 static Lisp_Object Qexpand_abbrev;
323 static Lisp_Object Qpost_self_insert_hook, Vpost_self_insert_hook;
325 static int
326 internal_self_insert (int c, int n)
328 int hairy = 0;
329 Lisp_Object tem;
330 register enum syntaxcode synt;
331 Lisp_Object overwrite;
332 /* Length of multi-byte form of C. */
333 int len;
334 /* Working buffer and pointer for multi-byte form of C. */
335 unsigned char str[MAX_MULTIBYTE_LENGTH];
336 int chars_to_delete = 0;
337 int spaces_to_insert = 0;
339 overwrite = current_buffer->overwrite_mode;
340 if (!NILP (Vbefore_change_functions) || !NILP (Vafter_change_functions))
341 hairy = 1;
343 /* At first, get multi-byte form of C in STR. */
344 if (!NILP (current_buffer->enable_multibyte_characters))
346 len = CHAR_STRING (c, str);
347 if (len == 1)
348 /* If C has modifier bits, this makes C an appropriate
349 one-byte char. */
350 c = *str;
352 else
354 str[0] = (SINGLE_BYTE_CHAR_P (c)
356 : multibyte_char_to_unibyte (c, Qnil));
357 len = 1;
359 if (!NILP (overwrite)
360 && PT < ZV)
362 /* In overwrite-mode, we substitute a character at point (C2,
363 hereafter) by C. For that, we delete C2 in advance. But,
364 just substituting C2 by C may move a remaining text in the
365 line to the right or to the left, which is not preferable.
366 So we insert more spaces or delete more characters in the
367 following cases: if C is narrower than C2, after deleting C2,
368 we fill columns with spaces, if C is wider than C2, we delete
369 C2 and several characters following C2. */
371 /* This is the character after point. */
372 int c2 = FETCH_CHAR (PT_BYTE);
374 /* Overwriting in binary-mode always replaces C2 by C.
375 Overwriting in textual-mode doesn't always do that.
376 It inserts newlines in the usual way,
377 and inserts any character at end of line
378 or before a tab if it doesn't use the whole width of the tab. */
379 if (EQ (overwrite, Qoverwrite_mode_binary))
380 chars_to_delete = n;
381 else if (c != '\n' && c2 != '\n')
383 int pos = PT;
384 int pos_byte = PT_BYTE;
385 /* Column the cursor should be placed at after this insertion.
386 The correct value should be calculated only when necessary. */
387 int target_clm = ((int) current_column () /* iftc */
388 + n * XINT (Fchar_width (make_number (c))));
390 /* The actual cursor position after the trial of moving
391 to column TARGET_CLM. It is greater than TARGET_CLM
392 if the TARGET_CLM is middle of multi-column
393 character. In that case, the new point is set after
394 that character. */
395 int actual_clm
396 = XFASTINT (Fmove_to_column (make_number (target_clm), Qnil));
398 chars_to_delete = PT - pos;
400 if (actual_clm > target_clm)
401 { /* We will delete too many columns. Let's fill columns
402 by spaces so that the remaining text won't move. */
403 EMACS_INT actual = PT_BYTE;
404 DEC_POS (actual);
405 if (FETCH_CHAR (actual) == '\t')
406 /* Rather than add spaces, let's just keep the tab. */
407 chars_to_delete--;
408 else
409 spaces_to_insert = actual_clm - target_clm;
412 SET_PT_BOTH (pos, pos_byte);
414 hairy = 2;
417 synt = SYNTAX (c);
419 if (!NILP (current_buffer->abbrev_mode)
420 && synt != Sword
421 && NILP (current_buffer->read_only)
422 && PT > BEGV
423 && (SYNTAX (!NILP (current_buffer->enable_multibyte_characters)
424 ? XFASTINT (Fprevious_char ())
425 : UNIBYTE_TO_CHAR (XFASTINT (Fprevious_char ())))
426 == Sword))
428 int modiff = MODIFF;
429 Lisp_Object sym;
431 sym = call0 (Qexpand_abbrev);
433 /* If we expanded an abbrev which has a hook,
434 and the hook has a non-nil `no-self-insert' property,
435 return right away--don't really self-insert. */
436 if (SYMBOLP (sym) && ! NILP (sym) && ! NILP (XSYMBOL (sym)->function)
437 && SYMBOLP (XSYMBOL (sym)->function))
439 Lisp_Object prop;
440 prop = Fget (XSYMBOL (sym)->function, intern ("no-self-insert"));
441 if (! NILP (prop))
442 return 1;
445 if (MODIFF != modiff)
446 hairy = 2;
449 if (chars_to_delete)
451 int mc = ((NILP (current_buffer->enable_multibyte_characters)
452 && SINGLE_BYTE_CHAR_P (c))
453 ? UNIBYTE_TO_CHAR (c) : c);
454 Lisp_Object string = Fmake_string (make_number (n), make_number (mc));
456 if (spaces_to_insert)
458 tem = Fmake_string (make_number (spaces_to_insert),
459 make_number (' '));
460 string = concat2 (string, tem);
463 replace_range (PT, PT + chars_to_delete, string, 1, 1, 1);
464 Fforward_char (make_number (n + spaces_to_insert));
466 else if (n > 1)
468 USE_SAFE_ALLOCA;
469 unsigned char *strn, *p;
470 SAFE_ALLOCA (strn, unsigned char*, n * len);
471 for (p = strn; n > 0; n--, p += len)
472 memcpy (p, str, len);
473 insert_and_inherit (strn, p - strn);
474 SAFE_FREE ();
476 else
477 insert_and_inherit (str, len);
479 if ((CHAR_TABLE_P (Vauto_fill_chars)
480 ? !NILP (CHAR_TABLE_REF (Vauto_fill_chars, c))
481 : (c == ' ' || c == '\n'))
482 && !NILP (current_buffer->auto_fill_function))
484 Lisp_Object tem;
486 if (c == '\n')
487 /* After inserting a newline, move to previous line and fill
488 that. Must have the newline in place already so filling and
489 justification, if any, know where the end is going to be. */
490 SET_PT_BOTH (PT - 1, PT_BYTE - 1);
491 tem = call0 (current_buffer->auto_fill_function);
492 /* Test PT < ZV in case the auto-fill-function is strange. */
493 if (c == '\n' && PT < ZV)
494 SET_PT_BOTH (PT + 1, PT_BYTE + 1);
495 if (!NILP (tem))
496 hairy = 2;
499 /* Run hooks for electric keys. */
500 call1 (Vrun_hooks, Qpost_self_insert_hook);
502 return hairy;
505 /* module initialization */
507 void
508 syms_of_cmds (void)
510 Qkill_backward_chars = intern_c_string ("kill-backward-chars");
511 staticpro (&Qkill_backward_chars);
513 Qkill_forward_chars = intern_c_string ("kill-forward-chars");
514 staticpro (&Qkill_forward_chars);
516 Qoverwrite_mode_binary = intern_c_string ("overwrite-mode-binary");
517 staticpro (&Qoverwrite_mode_binary);
519 Qexpand_abbrev = intern_c_string ("expand-abbrev");
520 staticpro (&Qexpand_abbrev);
522 Qpost_self_insert_hook = intern_c_string ("post-self-insert-hook");
523 staticpro (&Qpost_self_insert_hook);
525 DEFVAR_LISP ("post-self-insert-hook", &Vpost_self_insert_hook,
526 doc: /* Hook run at the end of `self-insert-command'.
527 This run is run after inserting the charater. */);
528 Vpost_self_insert_hook = Qnil;
530 defsubr (&Sforward_point);
531 defsubr (&Sforward_char);
532 defsubr (&Sbackward_char);
533 defsubr (&Sforward_line);
534 defsubr (&Sbeginning_of_line);
535 defsubr (&Send_of_line);
537 defsubr (&Sdelete_char);
538 defsubr (&Sself_insert_command);
541 void
542 keys_of_cmds (void)
544 int n;
546 nonundocount = 0;
547 initial_define_key (global_map, Ctl ('I'), "self-insert-command");
548 for (n = 040; n < 0177; n++)
549 initial_define_key (global_map, n, "self-insert-command");
550 #ifdef MSDOS
551 for (n = 0200; n < 0240; n++)
552 initial_define_key (global_map, n, "self-insert-command");
553 #endif
554 for (n = 0240; n < 0400; n++)
555 initial_define_key (global_map, n, "self-insert-command");
557 initial_define_key (global_map, Ctl ('A'), "beginning-of-line");
558 initial_define_key (global_map, Ctl ('B'), "backward-char");
559 initial_define_key (global_map, Ctl ('E'), "end-of-line");
560 initial_define_key (global_map, Ctl ('F'), "forward-char");
563 /* arch-tag: 022ba3cd-67f9-4978-9c5d-7d2b18d8644e
564 (do not change this comment) */