(custom-unlispify-remove-prefixes): New variable.
[bpt/emacs.git] / src / cmds.c
CommitLineData
cd645247 1/* Simple built-in editing commands.
cac55749 2 Copyright (C) 1985, 93, 94, 95, 96, 1997 Free Software Foundation, Inc.
cd645247
JB
3
4This file is part of GNU Emacs.
5
6GNU Emacs is free software; you can redistribute it and/or modify
7it under the terms of the GNU General Public License as published by
502ddf23 8the Free Software Foundation; either version 2, or (at your option)
cd645247
JB
9any later version.
10
11GNU Emacs is distributed in the hope that it will be useful,
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
17along with GNU Emacs; see the file COPYING. If not, write to
3b7ad313
EN
18the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19Boston, MA 02111-1307, USA. */
cd645247
JB
20
21
18160b98 22#include <config.h>
cd645247
JB
23#include "lisp.h"
24#include "commands.h"
25#include "buffer.h"
9e4fd67b 26#include "charset.h"
cd645247 27#include "syntax.h"
f109dfa2 28#include "window.h"
346e0c2d 29#include "keyboard.h"
cd645247
JB
30
31Lisp_Object Qkill_forward_chars, Qkill_backward_chars, Vblink_paren_function;
32
6bbb0d4a
JB
33/* A possible value for a buffer's overwrite-mode variable. */
34Lisp_Object Qoverwrite_mode_binary;
35
189fad68
RS
36/* Non-nil means put this face on the next self-inserting character. */
37Lisp_Object Vself_insert_face;
38
39/* This is the command that set up Vself_insert_face. */
40Lisp_Object Vself_insert_face_command;
41
a22ca1e0
RS
42/* Offset to add to a non-ASCII value when inserting it. */
43int nonascii_insert_offset;
44
189fad68 45extern Lisp_Object Qface;
cd645247 46\f
9e4fd67b
KH
47/* Return buffer position which is N characters after `point'. */
48int
49forward_point (n)
50 int n;
51{
52 int pos = PT, c;
53
54 if (!NILP (current_buffer->enable_multibyte_characters))
55 {
56 /* Simply adding N to `point' doesn't work because of multi-byte
57 form. We had better not use INC_POS and DEC_POS because they
58 check the gap position every time. But, for the moment, we
59 need working code. */
60 if (n > 0)
61 {
62 while (pos < ZV && n--) INC_POS (pos);
63 if (pos < ZV) n++;
64 }
65 else
66 {
67 while (pos > BEGV && n++) DEC_POS (pos);
68 if (pos > BEGV) n--;
69 }
70 }
71 pos += n;
72
73 return pos;
74}
75
76DEFUN ("forward-point", Fforward_point, Sforward_point, 1, 1, 0,
77 "Return buffer position N characters after (before if N negative) point.")
78 (n)
79 Lisp_Object n;
80{
81 CHECK_NUMBER (n, 0);
82
83 return make_number (forward_point (XINT (n)));
84}
85
cd645247 86DEFUN ("forward-char", Fforward_char, Sforward_char, 0, 1, "p",
72d5f589 87 "Move point right N characters (left if N is negative).\n\
cd645247 88On reaching end of buffer, stop and signal error.")
72d5f589
EN
89 (n)
90 Lisp_Object n;
cd645247 91{
72d5f589
EN
92 if (NILP (n))
93 XSETFASTINT (n, 1);
cd645247 94 else
72d5f589 95 CHECK_NUMBER (n, 0);
cd645247 96
72d5f589 97 /* This used to just set point to point + XINT (n), and then check
7b502dc3
JB
98 to see if it was within boundaries. But now that SET_PT can
99 potentially do a lot of stuff (calling entering and exiting
100 hooks, etcetera), that's not a good approach. So we validate the
101 proposed position, then set point. */
102 {
9e4fd67b 103 int new_point = forward_point (XINT (n));
7b502dc3
JB
104
105 if (new_point < BEGV)
106 {
107 SET_PT (BEGV);
108 Fsignal (Qbeginning_of_buffer, Qnil);
109 }
110 if (new_point > ZV)
111 {
112 SET_PT (ZV);
113 Fsignal (Qend_of_buffer, Qnil);
114 }
115
116 SET_PT (new_point);
117 }
118
cd645247
JB
119 return Qnil;
120}
121
122DEFUN ("backward-char", Fbackward_char, Sbackward_char, 0, 1, "p",
72d5f589 123 "Move point left N characters (right if N is negative).\n\
cd645247 124On attempt to pass beginning or end of buffer, stop and signal error.")
72d5f589
EN
125 (n)
126 Lisp_Object n;
cd645247 127{
72d5f589
EN
128 if (NILP (n))
129 XSETFASTINT (n, 1);
cd645247 130 else
72d5f589 131 CHECK_NUMBER (n, 0);
cd645247 132
72d5f589
EN
133 XSETINT (n, - XINT (n));
134 return Fforward_char (n);
cd645247
JB
135}
136
137DEFUN ("forward-line", Fforward_line, Sforward_line, 0, 1, "p",
72d5f589
EN
138 "Move N lines forward (backward if N is negative).\n\
139Precisely, if point is on line I, move to the start of line I + N.\n\
cd645247
JB
140If there isn't room, go as far as possible (no error).\n\
141Returns the count of lines left to move. If moving forward,\n\
72d5f589
EN
142that is N - number of lines moved; if backward, N + number moved.\n\
143With positive N, a non-empty line at the end counts as one line\n\
cd645247
JB
144 successfully moved (for the return value).")
145 (n)
146 Lisp_Object n;
147{
6ec8bbd2 148 int pos2 = PT;
cd645247
JB
149 int pos;
150 int count, shortage, negp;
151
265a9e55 152 if (NILP (n))
cd645247
JB
153 count = 1;
154 else
155 {
156 CHECK_NUMBER (n, 0);
157 count = XINT (n);
158 }
159
160 negp = count <= 0;
4f5d0c3c 161 pos = scan_buffer ('\n', pos2, 0, count - negp, &shortage, 1);
cd645247
JB
162 if (shortage > 0
163 && (negp
502ddf23
JB
164 || (ZV > BEGV
165 && pos != pos2
9e4fd67b 166 && FETCH_BYTE (pos - 1) != '\n')))
cd645247
JB
167 shortage--;
168 SET_PT (pos);
169 return make_number (negp ? - shortage : shortage);
170}
171
172DEFUN ("beginning-of-line", Fbeginning_of_line, Sbeginning_of_line,
173 0, 1, "p",
174 "Move point to beginning of current line.\n\
72d5f589 175With argument N not nil or 1, move forward N - 1 lines first.\n\
cd645247
JB
176If scan reaches end of buffer, stop there without error.")
177 (n)
178 Lisp_Object n;
179{
265a9e55 180 if (NILP (n))
48c7cef2 181 XSETFASTINT (n, 1);
cd645247
JB
182 else
183 CHECK_NUMBER (n, 0);
184
38b294ca 185 SET_PT (XINT (Fline_beginning_position (n)));
cd645247
JB
186 return Qnil;
187}
188
189DEFUN ("end-of-line", Fend_of_line, Send_of_line,
190 0, 1, "p",
191 "Move point to end of current line.\n\
72d5f589 192With argument N not nil or 1, move forward N - 1 lines first.\n\
cd645247
JB
193If scan reaches end of buffer, stop there without error.")
194 (n)
195 Lisp_Object n;
196{
197 register int pos;
198 register int stop;
199
265a9e55 200 if (NILP (n))
48c7cef2 201 XSETFASTINT (n, 1);
cd645247
JB
202 else
203 CHECK_NUMBER (n, 0);
204
38b294ca 205 SET_PT (XINT (Fline_end_position (n)));
cd645247
JB
206
207 return Qnil;
208}
209
210DEFUN ("delete-char", Fdelete_char, Sdelete_char, 1, 2, "p\nP",
72d5f589 211 "Delete the following N characters (previous if N is negative).\n\
cd645247 212Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).\n\
72d5f589
EN
213Interactively, N is the prefix arg, and KILLFLAG is set if\n\
214N was explicitly specified.")
cd645247
JB
215 (n, killflag)
216 Lisp_Object n, killflag;
217{
9e4fd67b
KH
218 int pos;
219
cd645247
JB
220 CHECK_NUMBER (n, 0);
221
9e4fd67b 222 pos = forward_point (XINT (n));
265a9e55 223 if (NILP (killflag))
cd645247
JB
224 {
225 if (XINT (n) < 0)
226 {
9e4fd67b 227 if (pos < BEGV)
cd645247
JB
228 Fsignal (Qbeginning_of_buffer, Qnil);
229 else
9e4fd67b 230 del_range (pos, PT);
cd645247
JB
231 }
232 else
233 {
9e4fd67b 234 if (pos > ZV)
cd645247
JB
235 Fsignal (Qend_of_buffer, Qnil);
236 else
9e4fd67b 237 del_range (PT, pos);
cd645247
JB
238 }
239 }
240 else
241 {
242 call1 (Qkill_forward_chars, n);
243 }
244 return Qnil;
245}
246
247DEFUN ("delete-backward-char", Fdelete_backward_char, Sdelete_backward_char,
248 1, 2, "p\nP",
72d5f589 249 "Delete the previous N characters (following if N is negative).\n\
cd645247 250Optional second arg KILLFLAG non-nil means kill instead (save in kill ring).\n\
72d5f589
EN
251Interactively, N is the prefix arg, and KILLFLAG is set if\n\
252N was explicitly specified.")
cd645247
JB
253 (n, killflag)
254 Lisp_Object n, killflag;
255{
aa970069 256 Lisp_Object value;
7c983171 257 int deleted_special = 0;
9e4fd67b 258 int pos, i;
aa970069 259
cd645247 260 CHECK_NUMBER (n, 0);
aa970069 261
7c983171 262 /* See if we are about to delete a tab or newline backwards. */
9e4fd67b
KH
263 pos = PT;
264 for (i = 0; i < XINT (n) && pos > BEGV; i++)
aa970069 265 {
9e4fd67b
KH
266 int c;
267
268 DEC_POS (pos);
269 c = FETCH_BYTE (pos);
270 if (c == '\t' || c == '\n')
aa970069 271 {
7c983171 272 deleted_special = 1;
aa970069
RS
273 break;
274 }
275 }
276
aa970069
RS
277 /* In overwrite mode, back over columns while clearing them out,
278 unless at end of line. */
279 if (XINT (n) > 0
280 && ! NILP (current_buffer->overwrite_mode)
7c983171 281 && ! deleted_special
9e4fd67b 282 && ! (PT == ZV || FETCH_BYTE (PT) == '\n'))
aa970069 283 {
9e4fd67b
KH
284 int column = current_column ();
285
286 value = Fdelete_char (make_number (-XINT (n)), killflag);
287 i = column - current_column ();
cac55749 288 Finsert_char (make_number (' '), make_number (i), Qnil);
9e4fd67b 289 SET_PT (PT - i);
aa970069 290 }
9e4fd67b
KH
291 else
292 value = Fdelete_char (make_number (-XINT (n)), killflag);
aa970069
RS
293
294 return value;
cd645247
JB
295}
296
297DEFUN ("self-insert-command", Fself_insert_command, Sself_insert_command, 1, 1, "p",
298 "Insert the character you type.\n\
299Whichever character you type to run this command is inserted.")
72d5f589
EN
300 (n)
301 Lisp_Object n;
cd645247 302{
a22ca1e0
RS
303 int character = XINT (last_command_char);
304
72d5f589 305 CHECK_NUMBER (n, 0);
cd645247
JB
306
307 /* Barf if the key that invoked this was not a character. */
ed76f667 308 if (!INTEGERP (last_command_char))
cd645247 309 bitch_at_user ();
72d5f589 310 else if (XINT (n) >= 2 && NILP (current_buffer->overwrite_mode))
2718dfa4 311 {
a22ca1e0
RS
312 int modified_char = character;
313 /* Add the offset to the character, for Finsert_char.
314 We pass internal_self_insert the unmodified character
315 because it itself does this offsetting. */
316 if (modified_char >= 0200 && modified_char <= 0377
317 && ! NILP (current_buffer->enable_multibyte_characters))
318 modified_char += nonascii_insert_offset;
319
72d5f589 320 XSETFASTINT (n, XFASTINT (n) - 2);
2718dfa4 321 /* The first one might want to expand an abbrev. */
a22ca1e0 322 internal_self_insert (character, 1);
2718dfa4
RS
323 /* The bulk of the copies of this char can be inserted simply.
324 We don't have to handle a user-specified face specially
325 because it will get inherited from the first char inserted. */
a22ca1e0 326 Finsert_char (make_number (modified_char), n, Qt);
2718dfa4 327 /* The last one might want to auto-fill. */
a22ca1e0 328 internal_self_insert (character, 0);
2718dfa4 329 }
cd645247 330 else
72d5f589 331 while (XINT (n) > 0)
cd645247 332 {
f58dd69b 333 /* Ok since old and new vals both nonneg */
72d5f589 334 XSETFASTINT (n, XFASTINT (n) - 1);
a22ca1e0 335 internal_self_insert (character, XFASTINT (n) != 0);
cd645247
JB
336 }
337
338 return Qnil;
339}
340
9e4fd67b 341/* Insert character C. If NOAUTOFILL is nonzero, don't do autofill
4c6e656f
RS
342 even if it is enabled.
343
344 If this insertion is suitable for direct output (completely simple),
aa52fef9
RS
345 return 0. A value of 1 indicates this *might* not have been simple.
346 A value of 2 means this did things that call for an undo boundary. */
4c6e656f 347
9e4fd67b
KH
348internal_self_insert (c, noautofill)
349 int c;
cd645247
JB
350 int noautofill;
351{
352 extern Lisp_Object Fexpand_abbrev ();
353 int hairy = 0;
354 Lisp_Object tem;
355 register enum syntaxcode synt;
e7aacab7 356 Lisp_Object overwrite;
9e4fd67b
KH
357 /* Length of multi-byte form of C. */
358 int len;
359 /* Working buffer and pointer for multi-byte form of C. */
360 unsigned char workbuf[4], *str;
cd645247 361
a22ca1e0
RS
362 if (c >= 0200 && c <= 0377
363 && ! NILP (current_buffer->enable_multibyte_characters))
364 c += nonascii_insert_offset;
365
e7aacab7 366 overwrite = current_buffer->overwrite_mode;
166a4263
RS
367 if (!NILP (Vbefore_change_function) || !NILP (Vafter_change_function)
368 || !NILP (Vbefore_change_functions) || !NILP (Vafter_change_functions))
cd645247
JB
369 hairy = 1;
370
9e4fd67b
KH
371 /* At first, get multi-byte form of C in STR. */
372 if (!NILP (current_buffer->enable_multibyte_characters))
373 len = CHAR_STRING (c, workbuf, str);
374 else
375 workbuf[0] = c, str = workbuf, len = 1;
376
6bbb0d4a 377 if (!NILP (overwrite)
9e4fd67b 378 && PT < ZV)
cd645247 379 {
9e4fd67b
KH
380 /* In overwrite-mode, we substitute a character at point (C2,
381 hereafter) by C. For that, we delete C2 in advance. But,
382 just substituting C2 by C may move a remaining text in the
383 line to the right or to the left, which is not preferable.
384 So we insert more spaces or delete more characters in the
385 following cases: if C is narrower than C2, after deleting C2,
386 we fill columns with spaces, if C is wider than C2, we delete
387 C2 and several characters following C2. */
388
389 /* A code at `point'. Since this is checked only against
390 NEWLINE and TAB, we don't need a character code but only the
391 first byte of multi-byte form. */
392 unsigned char c2 = FETCH_BYTE (PT);
393 /* A column the cursor should be placed at after this insertion.
394 The correct value should be calculated only when necessary. */
395 int target_clm = 0;
396
397 /* Overwriting in binary-mode always substitute C2 by C. But,
398 overwriting in textual-mode does this substitution in the
399 case that C is not NEWLINE and C2 is not NEWLINE nor TAB. If
400 C2 is TAB, the substitution is done only when C2 is currently
401 expanded to 0 column, or more than 20 columns, or more than
402 the width of C. */
403 if (EQ (overwrite, Qoverwrite_mode_binary)
404 || (c != '\n'
405 && c2 != '\n'
406 && (target_clm = current_column() + WIDTH_BY_CHAR_HEAD (str[0]),
407 (c2 != '\t'
408 || XINT (current_buffer->tab_width) <= 0
409 || XFASTINT (current_buffer->tab_width) > 20
410 || !(target_clm % XFASTINT (current_buffer->tab_width))))))
411 {
412 if (target_clm == 0)
413 del_range (PT, forward_point (1));
414 else
415 {
5bfb66e3 416 int pos = PT;
9e4fd67b
KH
417 /* The actual cursor position after the trial of moving
418 to column TARGET_CLM. It is greater than TARGET_CLM
419 if the TARGET_CLM is middle of multi-column
420 character. In that case, the new point is set after
421 that character. */
cac55749
RS
422 int actual_clm
423 = XFASTINT (Fmove_to_column (make_number (target_clm), Qnil));
9e4fd67b
KH
424
425 del_range (pos, PT);
426 if (actual_clm > target_clm)
427 {
428 /* We deleted too many columns. Let's fill columns
429 by spaces so that the remaining text won't move. */
430 insert(" ", actual_clm - target_clm);
431 SET_PT (pos);
432 }
433 }
434 hairy = 2;
435 }
aa52fef9 436 hairy = 2;
cd645247 437 }
265a9e55 438 if (!NILP (current_buffer->abbrev_mode)
cd645247 439 && SYNTAX (c) != Sword
265a9e55 440 && NILP (current_buffer->read_only)
9e4fd67b 441 && PT > BEGV && SYNTAX (XFASTINT (Fprevious_char ())) == Sword)
cd645247 442 {
ee8caabb 443 int modiff = MODIFF;
e57640c0
RS
444 Lisp_Object sym;
445
446 sym = Fexpand_abbrev ();
447
448 /* If we expanded an abbrev which has only a hook,
9317a902 449 and the hook has a non-nil `no-self-insert' property,
e57640c0 450 return right away--don't really self-insert. */
9317a902
RS
451 if (! NILP (sym) && ! NILP (XSYMBOL (sym)->function)
452 && SYMBOLP (XSYMBOL (sym)->function))
e57640c0
RS
453 {
454 Lisp_Object prop;
9317a902 455 prop = Fget (XSYMBOL (sym)->function, intern ("no-self-insert"));
e57640c0 456 if (! NILP (prop))
6787d111 457 return 1;
e57640c0
RS
458 }
459
ee8caabb 460 if (MODIFF != modiff)
aa52fef9 461 hairy = 2;
cd645247
JB
462 }
463 if ((c == ' ' || c == '\n')
464 && !noautofill
3de15b7a 465 && !NILP (current_buffer->auto_fill_function))
cd645247 466 {
76bb6dbb
KH
467 Lisp_Object tem;
468
9e4fd67b
KH
469 insert_and_inherit (str, len);
470 if (c == '\n')
2e16553c
BG
471 /* After inserting a newline, move to previous line and fill */
472 /* that. Must have the newline in place already so filling and */
473 /* justification, if any, know where the end is going to be. */
6ec8bbd2 474 SET_PT (PT - 1);
76bb6dbb 475 tem = call0 (current_buffer->auto_fill_function);
9e4fd67b 476 if (c == '\n')
6ec8bbd2 477 SET_PT (PT + 1);
76bb6dbb
KH
478 if (!NILP (tem))
479 hairy = 2;
cd645247
JB
480 }
481 else
9e4fd67b 482 insert_and_inherit (str, len);
189fad68 483
38d404db 484#ifdef HAVE_FACES
189fad68
RS
485 /* If previous command specified a face to use, use it. */
486 if (!NILP (Vself_insert_face)
346e0c2d 487 && EQ (current_kboard->Vlast_command, Vself_insert_face_command))
189fad68
RS
488 {
489 Lisp_Object before, after;
9e4fd67b 490 XSETINT (before, PT - len);
189fad68
RS
491 XSETINT (after, PT);
492 Fput_text_property (before, after, Qface, Vself_insert_face, Qnil);
493 Vself_insert_face = Qnil;
494 }
38d404db 495#endif
cd645247
JB
496 synt = SYNTAX (c);
497 if ((synt == Sclose || synt == Smath)
2718dfa4
RS
498 && !NILP (Vblink_paren_function) && INTERACTIVE
499 && !noautofill)
cd645247
JB
500 {
501 call0 (Vblink_paren_function);
aa52fef9 502 hairy = 2;
cd645247
JB
503 }
504 return hairy;
505}
506\f
507/* module initialization */
508
509syms_of_cmds ()
510{
511 Qkill_backward_chars = intern ("kill-backward-chars");
512 staticpro (&Qkill_backward_chars);
513
514 Qkill_forward_chars = intern ("kill-forward-chars");
515 staticpro (&Qkill_forward_chars);
516
6bbb0d4a
JB
517 Qoverwrite_mode_binary = intern ("overwrite-mode-binary");
518 staticpro (&Qoverwrite_mode_binary);
e686c647 519
189fad68
RS
520 DEFVAR_LISP ("self-insert-face", &Vself_insert_face,
521 "If non-nil, set the face of the next self-inserting character to this.\n\
522See also `self-insert-face-command'.");
523 Vself_insert_face = Qnil;
524
525 DEFVAR_LISP ("self-insert-face-command", &Vself_insert_face_command,
526 "This is the command that set up `self-insert-face'.\n\
527If `last-command' does not equal this value, we ignore `self-insert-face'.");
528 Vself_insert_face_command = Qnil;
529
cd645247
JB
530 DEFVAR_LISP ("blink-paren-function", &Vblink_paren_function,
531 "Function called, if non-nil, whenever a close parenthesis is inserted.\n\
532More precisely, a char with closeparen syntax is self-inserted.");
533 Vblink_paren_function = Qnil;
534
a22ca1e0
RS
535 DEFVAR_INT ("nonascii-insert-offset", &nonascii_insert_offset,
536 "Offset to add to a non-ascii code 0200...0377 when inserting it.\n\
537This applies only when multibyte characters are enabled, and it serves\n\
538to convert a Latin-1 or similar 8-bit character code to the corresponding\n\
539Emacs character code.");
540 nonascii_insert_offset = 0;
541
9e4fd67b 542 defsubr (&Sforward_point);
cd645247
JB
543 defsubr (&Sforward_char);
544 defsubr (&Sbackward_char);
545 defsubr (&Sforward_line);
546 defsubr (&Sbeginning_of_line);
547 defsubr (&Send_of_line);
548
549 defsubr (&Sdelete_char);
550 defsubr (&Sdelete_backward_char);
551
552 defsubr (&Sself_insert_command);
cd645247
JB
553}
554
555keys_of_cmds ()
556{
557 int n;
558
cbf65115 559 initial_define_key (global_map, Ctl ('I'), "self-insert-command");
cd645247
JB
560 for (n = 040; n < 0177; n++)
561 initial_define_key (global_map, n, "self-insert-command");
cf9cdc11
RS
562#ifdef MSDOS
563 for (n = 0200; n < 0240; n++)
564 initial_define_key (global_map, n, "self-insert-command");
565#endif
94748cb9 566 for (n = 0240; n < 0400; n++)
eb46da6a 567 initial_define_key (global_map, n, "self-insert-command");
cd645247
JB
568
569 initial_define_key (global_map, Ctl ('A'), "beginning-of-line");
570 initial_define_key (global_map, Ctl ('B'), "backward-char");
571 initial_define_key (global_map, Ctl ('D'), "delete-char");
572 initial_define_key (global_map, Ctl ('E'), "end-of-line");
573 initial_define_key (global_map, Ctl ('F'), "forward-char");
574 initial_define_key (global_map, 0177, "delete-backward-char");
575}