* lib-src/fakemail.c (action): Convert function definitions to standard C.
[bpt/emacs.git] / src / cmds.c
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.
5
6 This file is part of GNU Emacs.
7
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.
12
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.
17
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/>. */
20
21
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"
34
35 Lisp_Object Qkill_forward_chars, Qkill_backward_chars, Vblink_paren_function;
36
37 /* A possible value for a buffer's overwrite-mode variable. */
38 Lisp_Object Qoverwrite_mode_binary;
39
40 /* Non-nil means put this face on the next self-inserting character. */
41 Lisp_Object Vself_insert_face;
42
43 /* This is the command that set up Vself_insert_face. */
44 Lisp_Object Vself_insert_face_command;
45
46 extern Lisp_Object Qface;
47 extern Lisp_Object Vtranslation_table_for_input;
48 \f
49 DEFUN ("forward-point", Fforward_point, Sforward_point, 1, 1, 0,
50 doc: /* Return buffer position N characters after (before if N negative) point. */)
51 (n)
52 Lisp_Object n;
53 {
54 CHECK_NUMBER (n);
55
56 return make_number (PT + XINT (n));
57 }
58
59 DEFUN ("forward-char", Fforward_char, Sforward_char, 0, 1, "^p",
60 doc: /* Move point N characters forward (backward if N is negative).
61 On reaching end or beginning of buffer, stop and signal error.
62
63 Depending on the bidirectional context, the movement may be to the
64 right or to the left on the screen. This is in contrast with
65 \\[right-char], which see. */)
66 (n)
67 Lisp_Object n;
68 {
69 if (NILP (n))
70 XSETFASTINT (n, 1);
71 else
72 CHECK_NUMBER (n);
73
74 /* This used to just set point to point + XINT (n), and then check
75 to see if it was within boundaries. But now that SET_PT can
76 potentially do a lot of stuff (calling entering and exiting
77 hooks, etcetera), that's not a good approach. So we validate the
78 proposed position, then set point. */
79 {
80 int new_point = PT + XINT (n);
81
82 if (new_point < BEGV)
83 {
84 SET_PT (BEGV);
85 xsignal0 (Qbeginning_of_buffer);
86 }
87 if (new_point > ZV)
88 {
89 SET_PT (ZV);
90 xsignal0 (Qend_of_buffer);
91 }
92
93 SET_PT (new_point);
94 }
95
96 return Qnil;
97 }
98
99 DEFUN ("backward-char", Fbackward_char, Sbackward_char, 0, 1, "^p",
100 doc: /* Move point N characters backward (forward if N is negative).
101 On attempt to pass beginning or end of buffer, stop and signal error.
102
103 Depending on the bidirectional context, the movement may be to the
104 right or to the left on the screen. This is in contrast with
105 \\[left-char], which see. */)
106 (n)
107 Lisp_Object n;
108 {
109 if (NILP (n))
110 XSETFASTINT (n, 1);
111 else
112 CHECK_NUMBER (n);
113
114 XSETINT (n, - XINT (n));
115 return Fforward_char (n);
116 }
117
118 DEFUN ("forward-line", Fforward_line, Sforward_line, 0, 1, "^p",
119 doc: /* Move N lines forward (backward if N is negative).
120 Precisely, if point is on line I, move to the start of line I + N.
121 If there isn't room, go as far as possible (no error).
122 Returns the count of lines left to move. If moving forward,
123 that is N - number of lines moved; if backward, N + number moved.
124 With positive N, a non-empty line at the end counts as one line
125 successfully moved (for the return value). */)
126 (n)
127 Lisp_Object n;
128 {
129 int opoint = PT, opoint_byte = PT_BYTE;
130 int pos, pos_byte;
131 int count, shortage;
132
133 if (NILP (n))
134 count = 1;
135 else
136 {
137 CHECK_NUMBER (n);
138 count = XINT (n);
139 }
140
141 if (count <= 0)
142 shortage = scan_newline (PT, PT_BYTE, BEGV, BEGV_BYTE, count - 1, 1);
143 else
144 shortage = scan_newline (PT, PT_BYTE, ZV, ZV_BYTE, count, 1);
145
146 /* Since scan_newline does TEMP_SET_PT_BOTH,
147 and we want to set PT "for real",
148 go back to the old point and then come back here. */
149 pos = PT;
150 pos_byte = PT_BYTE;
151 TEMP_SET_PT_BOTH (opoint, opoint_byte);
152 SET_PT_BOTH (pos, pos_byte);
153
154 if (shortage > 0
155 && (count <= 0
156 || (ZV > BEGV
157 && PT != opoint
158 && (FETCH_BYTE (PT_BYTE - 1) != '\n'))))
159 shortage--;
160
161 return make_number (count <= 0 ? - shortage : shortage);
162 }
163
164 DEFUN ("beginning-of-line", Fbeginning_of_line, Sbeginning_of_line, 0, 1, "^p",
165 doc: /* Move point to beginning of current line.
166 With argument N not nil or 1, move forward N - 1 lines first.
167 If point reaches the beginning or end of buffer, it stops there.
168
169 This function constrains point to the current field unless this moves
170 point to a different line than the original, unconstrained result.
171 If N is nil or 1, and a front-sticky field starts at point, the point
172 does not move. To ignore field boundaries bind
173 `inhibit-field-text-motion' to t, or use the `forward-line' function
174 instead. For instance, `(forward-line 0)' does the same thing as
175 `(beginning-of-line)', except that it ignores field boundaries. */)
176 (n)
177 Lisp_Object n;
178 {
179 if (NILP (n))
180 XSETFASTINT (n, 1);
181 else
182 CHECK_NUMBER (n);
183
184 SET_PT (XINT (Fline_beginning_position (n)));
185
186 return Qnil;
187 }
188
189 DEFUN ("end-of-line", Fend_of_line, Send_of_line, 0, 1, "^p",
190 doc: /* Move point to end of current line.
191 With argument N not nil or 1, move forward N - 1 lines first.
192 If point reaches the beginning or end of buffer, it stops there.
193 To ignore intangibility, bind `inhibit-point-motion-hooks' to t.
194
195 This function constrains point to the current field unless this moves
196 point to a different line than the original, unconstrained result. If
197 N is nil or 1, and a rear-sticky field ends at point, the point does
198 not move. To ignore field boundaries bind `inhibit-field-text-motion'
199 to t. */)
200 (n)
201 Lisp_Object n;
202 {
203 int newpos;
204
205 if (NILP (n))
206 XSETFASTINT (n, 1);
207 else
208 CHECK_NUMBER (n);
209
210 while (1)
211 {
212 newpos = XINT (Fline_end_position (n));
213 SET_PT (newpos);
214
215 if (PT > newpos
216 && FETCH_CHAR (PT - 1) == '\n')
217 {
218 /* If we skipped over a newline that follows
219 an invisible intangible run,
220 move back to the last tangible position
221 within the line. */
222
223 SET_PT (PT - 1);
224 break;
225 }
226 else if (PT > newpos && PT < ZV
227 && FETCH_CHAR (PT) != '\n')
228 /* If we skipped something intangible
229 and now we're not really at eol,
230 keep going. */
231 n = make_number (1);
232 else
233 break;
234 }
235
236 return Qnil;
237 }
238
239 DEFUN ("delete-char", Fdelete_char, Sdelete_char, 1, 2, "p\nP",
240 doc: /* Delete the following N characters (previous if N is negative).
241 Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).
242 Interactively, N is the prefix arg, and KILLFLAG is set if
243 N was explicitly specified.
244
245 The command `delete-forward' is preferable for interactive use. */)
246 (n, killflag)
247 Lisp_Object n, killflag;
248 {
249 int pos;
250
251 CHECK_NUMBER (n);
252
253 pos = PT + XINT (n);
254 if (NILP (killflag))
255 {
256 if (XINT (n) < 0)
257 {
258 if (pos < BEGV)
259 xsignal0 (Qbeginning_of_buffer);
260 else
261 del_range (pos, PT);
262 }
263 else
264 {
265 if (pos > ZV)
266 xsignal0 (Qend_of_buffer);
267 else
268 del_range (PT, pos);
269 }
270 }
271 else
272 {
273 call1 (Qkill_forward_chars, n);
274 }
275 return Qnil;
276 }
277
278 static int nonundocount;
279
280 /* Note that there's code in command_loop_1 which typically avoids
281 calling this. */
282 DEFUN ("self-insert-command", Fself_insert_command, Sself_insert_command, 1, 1, "p",
283 doc: /* Insert the character you type.
284 Whichever character you type to run this command is inserted.
285 Before insertion, `expand-abbrev' is executed if the inserted character does
286 not have word syntax and the previous character in the buffer does.
287 After insertion, the value of `auto-fill-function' is called if the
288 `auto-fill-chars' table has a non-nil value for the inserted character. */)
289 (n)
290 Lisp_Object n;
291 {
292 int remove_boundary = 1;
293 CHECK_NUMBER (n);
294
295 if (!EQ (Vthis_command, current_kboard->Vlast_command))
296 nonundocount = 0;
297
298 if (NILP (Vexecuting_kbd_macro)
299 && !EQ (minibuf_window, selected_window))
300 {
301 if (nonundocount <= 0 || nonundocount >= 20)
302 {
303 remove_boundary = 0;
304 nonundocount = 0;
305 }
306 nonundocount++;
307 }
308
309 if (remove_boundary
310 && CONSP (current_buffer->undo_list)
311 && NILP (XCAR (current_buffer->undo_list)))
312 /* Remove the undo_boundary that was just pushed. */
313 current_buffer->undo_list = XCDR (current_buffer->undo_list);
314
315 /* Barf if the key that invoked this was not a character. */
316 if (!CHARACTERP (last_command_event))
317 bitch_at_user ();
318 {
319 int character = translate_char (Vtranslation_table_for_input,
320 XINT (last_command_event));
321 if (XINT (n) >= 2 && NILP (current_buffer->overwrite_mode))
322 {
323 XSETFASTINT (n, XFASTINT (n) - 2);
324 /* The first one might want to expand an abbrev. */
325 internal_self_insert (character, 1);
326 /* The bulk of the copies of this char can be inserted simply.
327 We don't have to handle a user-specified face specially
328 because it will get inherited from the first char inserted. */
329 Finsert_char (make_number (character), n, Qt);
330 /* The last one might want to auto-fill. */
331 internal_self_insert (character, 0);
332 }
333 else
334 while (XINT (n) > 0)
335 {
336 int val;
337 /* Ok since old and new vals both nonneg */
338 XSETFASTINT (n, XFASTINT (n) - 1);
339 val = internal_self_insert (character, XFASTINT (n) != 0);
340 if (val == 2)
341 nonundocount = 0;
342 frame_make_pointer_invisible ();
343 }
344 }
345
346 return Qnil;
347 }
348
349 /* Insert character C. If NOAUTOFILL is nonzero, don't do autofill
350 even if it is enabled.
351
352 If this insertion is suitable for direct output (completely simple),
353 return 0. A value of 1 indicates this *might* not have been simple.
354 A value of 2 means this did things that call for an undo boundary. */
355
356 static Lisp_Object Qexpand_abbrev;
357
358 int
359 internal_self_insert (c, noautofill)
360 int c;
361 int noautofill;
362 {
363 int hairy = 0;
364 Lisp_Object tem;
365 register enum syntaxcode synt;
366 Lisp_Object overwrite, string;
367 /* Length of multi-byte form of C. */
368 int len;
369 /* Working buffer and pointer for multi-byte form of C. */
370 unsigned char str[MAX_MULTIBYTE_LENGTH];
371 int chars_to_delete = 0;
372 int spaces_to_insert = 0;
373
374 overwrite = current_buffer->overwrite_mode;
375 if (!NILP (Vbefore_change_functions) || !NILP (Vafter_change_functions))
376 hairy = 1;
377
378 /* At first, get multi-byte form of C in STR. */
379 if (!NILP (current_buffer->enable_multibyte_characters))
380 {
381 len = CHAR_STRING (c, str);
382 if (len == 1)
383 /* If C has modifier bits, this makes C an appropriate
384 one-byte char. */
385 c = *str;
386 }
387 else
388 {
389 str[0] = (SINGLE_BYTE_CHAR_P (c)
390 ? c
391 : multibyte_char_to_unibyte (c, Qnil));
392 len = 1;
393 }
394 if (!NILP (overwrite)
395 && PT < ZV)
396 {
397 /* In overwrite-mode, we substitute a character at point (C2,
398 hereafter) by C. For that, we delete C2 in advance. But,
399 just substituting C2 by C may move a remaining text in the
400 line to the right or to the left, which is not preferable.
401 So we insert more spaces or delete more characters in the
402 following cases: if C is narrower than C2, after deleting C2,
403 we fill columns with spaces, if C is wider than C2, we delete
404 C2 and several characters following C2. */
405
406 /* This is the character after point. */
407 int c2 = FETCH_CHAR (PT_BYTE);
408
409 /* Column the cursor should be placed at after this insertion.
410 The correct value should be calculated only when necessary. */
411 int target_clm = 0;
412
413 /* Overwriting in binary-mode always replaces C2 by C.
414 Overwriting in textual-mode doesn't always do that.
415 It inserts newlines in the usual way,
416 and inserts any character at end of line
417 or before a tab if it doesn't use the whole width of the tab. */
418 if (EQ (overwrite, Qoverwrite_mode_binary)
419 || (c != '\n'
420 && c2 != '\n'
421 && ! (c2 == '\t'
422 && XINT (current_buffer->tab_width) > 0
423 && XFASTINT (current_buffer->tab_width) < 20
424 && (target_clm = ((int) current_column () /* iftc */
425 + XINT (Fchar_width (make_number (c)))),
426 target_clm % XFASTINT (current_buffer->tab_width)))))
427 {
428 int pos = PT;
429 int pos_byte = PT_BYTE;
430
431 if (target_clm == 0)
432 chars_to_delete = 1;
433 else
434 {
435 /* The actual cursor position after the trial of moving
436 to column TARGET_CLM. It is greater than TARGET_CLM
437 if the TARGET_CLM is middle of multi-column
438 character. In that case, the new point is set after
439 that character. */
440 int actual_clm
441 = XFASTINT (Fmove_to_column (make_number (target_clm), Qnil));
442
443 chars_to_delete = PT - pos;
444
445 if (actual_clm > target_clm)
446 {
447 /* We will delete too many columns. Let's fill columns
448 by spaces so that the remaining text won't move. */
449 spaces_to_insert = actual_clm - target_clm;
450 }
451 }
452 SET_PT_BOTH (pos, pos_byte);
453 hairy = 2;
454 }
455 hairy = 2;
456 }
457
458 synt = SYNTAX (c);
459
460 if (!NILP (current_buffer->abbrev_mode)
461 && synt != Sword
462 && NILP (current_buffer->read_only)
463 && PT > BEGV
464 && (!NILP (current_buffer->enable_multibyte_characters)
465 ? SYNTAX (XFASTINT (Fprevious_char ())) == Sword
466 : (SYNTAX (UNIBYTE_TO_CHAR (XFASTINT (Fprevious_char ())))
467 == Sword)))
468 {
469 int modiff = MODIFF;
470 Lisp_Object sym;
471
472 sym = call0 (Qexpand_abbrev);
473
474 /* If we expanded an abbrev which has a hook,
475 and the hook has a non-nil `no-self-insert' property,
476 return right away--don't really self-insert. */
477 if (SYMBOLP (sym) && ! NILP (sym) && ! NILP (XSYMBOL (sym)->function)
478 && SYMBOLP (XSYMBOL (sym)->function))
479 {
480 Lisp_Object prop;
481 prop = Fget (XSYMBOL (sym)->function, intern ("no-self-insert"));
482 if (! NILP (prop))
483 return 1;
484 }
485
486 if (MODIFF != modiff)
487 hairy = 2;
488 }
489
490 if (chars_to_delete)
491 {
492 string = make_string_from_bytes (str, 1, len);
493 if (spaces_to_insert)
494 {
495 tem = Fmake_string (make_number (spaces_to_insert),
496 make_number (' '));
497 string = concat2 (tem, string);
498 }
499
500 replace_range (PT, PT + chars_to_delete, string, 1, 1, 1);
501 Fforward_char (make_number (1 + spaces_to_insert));
502 }
503 else
504 insert_and_inherit (str, len);
505
506 if ((CHAR_TABLE_P (Vauto_fill_chars)
507 ? !NILP (CHAR_TABLE_REF (Vauto_fill_chars, c))
508 : (c == ' ' || c == '\n'))
509 && !noautofill
510 && !NILP (current_buffer->auto_fill_function))
511 {
512 Lisp_Object tem;
513
514 if (c == '\n')
515 /* After inserting a newline, move to previous line and fill
516 that. Must have the newline in place already so filling and
517 justification, if any, know where the end is going to be. */
518 SET_PT_BOTH (PT - 1, PT_BYTE - 1);
519 tem = call0 (current_buffer->auto_fill_function);
520 /* Test PT < ZV in case the auto-fill-function is strange. */
521 if (c == '\n' && PT < ZV)
522 SET_PT_BOTH (PT + 1, PT_BYTE + 1);
523 if (!NILP (tem))
524 hairy = 2;
525 }
526
527 /* If previous command specified a face to use, use it. */
528 if (!NILP (Vself_insert_face)
529 && EQ (current_kboard->Vlast_command, Vself_insert_face_command))
530 {
531 Fput_text_property (make_number (PT - 1), make_number (PT),
532 Qface, Vself_insert_face, Qnil);
533 Vself_insert_face = Qnil;
534 }
535
536 if ((synt == Sclose || synt == Smath)
537 && !NILP (Vblink_paren_function) && INTERACTIVE
538 && !noautofill)
539 {
540 call0 (Vblink_paren_function);
541 hairy = 2;
542 }
543 return hairy;
544 }
545 \f
546 /* module initialization */
547
548 void
549 syms_of_cmds ()
550 {
551 Qkill_backward_chars = intern_c_string ("kill-backward-chars");
552 staticpro (&Qkill_backward_chars);
553
554 Qkill_forward_chars = intern_c_string ("kill-forward-chars");
555 staticpro (&Qkill_forward_chars);
556
557 Qoverwrite_mode_binary = intern_c_string ("overwrite-mode-binary");
558 staticpro (&Qoverwrite_mode_binary);
559
560 Qexpand_abbrev = intern_c_string ("expand-abbrev");
561 staticpro (&Qexpand_abbrev);
562
563 DEFVAR_LISP ("self-insert-face", &Vself_insert_face,
564 doc: /* If non-nil, set the face of the next self-inserting character to this.
565 See also `self-insert-face-command'. */);
566 Vself_insert_face = Qnil;
567
568 DEFVAR_LISP ("self-insert-face-command", &Vself_insert_face_command,
569 doc: /* This is the command that set up `self-insert-face'.
570 If `last-command' does not equal this value, we ignore `self-insert-face'. */);
571 Vself_insert_face_command = Qnil;
572
573 DEFVAR_LISP ("blink-paren-function", &Vblink_paren_function,
574 doc: /* Function called, if non-nil, whenever a close parenthesis is inserted.
575 More precisely, a char with closeparen syntax is self-inserted. */);
576 Vblink_paren_function = Qnil;
577
578 defsubr (&Sforward_point);
579 defsubr (&Sforward_char);
580 defsubr (&Sbackward_char);
581 defsubr (&Sforward_line);
582 defsubr (&Sbeginning_of_line);
583 defsubr (&Send_of_line);
584
585 defsubr (&Sdelete_char);
586 defsubr (&Sself_insert_command);
587 }
588
589 void
590 keys_of_cmds ()
591 {
592 int n;
593
594 nonundocount = 0;
595 initial_define_key (global_map, Ctl ('I'), "self-insert-command");
596 for (n = 040; n < 0177; n++)
597 initial_define_key (global_map, n, "self-insert-command");
598 #ifdef MSDOS
599 for (n = 0200; n < 0240; n++)
600 initial_define_key (global_map, n, "self-insert-command");
601 #endif
602 for (n = 0240; n < 0400; n++)
603 initial_define_key (global_map, n, "self-insert-command");
604
605 initial_define_key (global_map, Ctl ('A'), "beginning-of-line");
606 initial_define_key (global_map, Ctl ('B'), "backward-char");
607 initial_define_key (global_map, Ctl ('E'), "end-of-line");
608 initial_define_key (global_map, Ctl ('F'), "forward-char");
609 }
610
611 /* arch-tag: 022ba3cd-67f9-4978-9c5d-7d2b18d8644e
612 (do not change this comment) */