Switch license to GPLv3 or later.
[bpt/emacs.git] / src / indent.c
CommitLineData
993b6404 1/* Indentation functions.
e01732fa 2 Copyright (C) 1985, 1986, 1987, 1988, 1993, 1994, 1995, 1998, 2000, 2001,
4e6835db 3 2002, 2003, 2004, 2005, 2006, 2007 Free Software Foundation, Inc.
993b6404
JB
4
5This file is part of GNU Emacs.
6
7GNU Emacs is free software; you can redistribute it and/or modify
8it under the terms of the GNU General Public License as published by
684d6f5b 9the Free Software Foundation; either version 3, or (at your option)
993b6404
JB
10any later version.
11
12GNU Emacs is distributed in the hope that it will be useful,
13but WITHOUT ANY WARRANTY; without even the implied warranty of
14MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15GNU General Public License for more details.
16
17You should have received a copy of the GNU General Public License
18along with GNU Emacs; see the file COPYING. If not, write to
4fc5845f
LK
19the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20Boston, MA 02110-1301, USA. */
993b6404 21
18160b98 22#include <config.h>
993b6404
JB
23#include "lisp.h"
24#include "buffer.h"
a997a7ca 25#include "charset.h"
fb911777 26#include "category.h"
993b6404 27#include "indent.h"
2538fae4 28#include "keyboard.h"
502b9b64 29#include "frame.h"
993b6404
JB
30#include "window.h"
31#include "termchar.h"
32#include "termopts.h"
33#include "disptab.h"
5a05d3d2 34#include "intervals.h"
0aa01123 35#include "region-cache.h"
993b6404
JB
36
37/* Indentation can insert tabs if this is non-zero;
88c6e37e
GM
38 otherwise always uses spaces. */
39
993b6404
JB
40int indent_tabs_mode;
41
993b6404
JB
42#define CR 015
43
79c2a4fc 44/* These three values memorize the current column to avoid recalculation. */
88c6e37e
GM
45
46/* Last value returned by current_column.
47 Some things in set last_known_column_point to -1
79c2a4fc 48 to mark the memorized value as invalid. */
88c6e37e 49
76e20cb0 50double last_known_column;
88c6e37e
GM
51
52/* Value of point when current_column was called. */
53
993b6404 54int last_known_column_point;
88c6e37e
GM
55
56/* Value of MODIFF when current_column was called. */
57
993b6404
JB
58int last_known_column_modified;
59
76e20cb0
RS
60static double current_column_1 P_ ((void));
61static double position_indentation P_ ((int));
82d593eb 62
a997a7ca
KH
63/* Cache of beginning of line found by the last call of
64 current_column. */
88c6e37e 65
a997a7ca
KH
66int current_column_bol_cache;
67
993b6404
JB
68/* Get the display table to use for the current buffer. */
69
d44f12b4 70struct Lisp_Char_Table *
993b6404
JB
71buffer_display_table ()
72{
73 Lisp_Object thisbuf;
74
75 thisbuf = current_buffer->display_table;
d44f12b4
RS
76 if (DISP_TABLE_P (thisbuf))
77 return XCHAR_TABLE (thisbuf);
78 if (DISP_TABLE_P (Vstandard_display_table))
79 return XCHAR_TABLE (Vstandard_display_table);
993b6404
JB
80 return 0;
81}
82\f
0aa01123
JB
83/* Width run cache considerations. */
84
85/* Return the width of character C under display table DP. */
f845b8b2 86
0aa01123
JB
87static int
88character_width (c, dp)
89 int c;
d44f12b4 90 struct Lisp_Char_Table *dp;
0aa01123
JB
91{
92 Lisp_Object elt;
93
94 /* These width computations were determined by examining the cases
95 in display_text_line. */
96
f845b8b2 97 /* Everything can be handled by the display table, if it's
0aa01123 98 present and the element is right. */
f845b8b2 99 if (dp && (elt = DISP_CHAR_VECTOR (dp, c), VECTORP (elt)))
0aa01123
JB
100 return XVECTOR (elt)->size;
101
f845b8b2
RS
102 /* Some characters are special. */
103 if (c == '\n' || c == '\t' || c == '\015')
104 return 0;
105
106 /* Printing characters have width 1. */
0aa01123
JB
107 else if (c >= 040 && c < 0177)
108 return 1;
109
110 /* Everybody else (control characters, metacharacters) has other
111 widths. We could return their actual widths here, but they
112 depend on things like ctl_arrow and crud like that, and they're
113 not very common at all. So we'll just claim we don't know their
114 widths. */
115 else
116 return 0;
117}
118
119/* Return true iff the display table DISPTAB specifies the same widths
120 for characters as WIDTHTAB. We use this to decide when to
121 invalidate the buffer's width_run_cache. */
88c6e37e 122
0aa01123
JB
123int
124disptab_matches_widthtab (disptab, widthtab)
d44f12b4 125 struct Lisp_Char_Table *disptab;
0aa01123
JB
126 struct Lisp_Vector *widthtab;
127{
128 int i;
129
130 if (widthtab->size != 256)
131 abort ();
132
133 for (i = 0; i < 256; i++)
134 if (character_width (i, disptab)
135 != XFASTINT (widthtab->contents[i]))
136 return 0;
137
138 return 1;
2ff4775b 139}
0aa01123
JB
140
141/* Recompute BUF's width table, using the display table DISPTAB. */
88c6e37e 142
0aa01123
JB
143void
144recompute_width_table (buf, disptab)
145 struct buffer *buf;
d44f12b4 146 struct Lisp_Char_Table *disptab;
0aa01123
JB
147{
148 int i;
228a2e1a 149 struct Lisp_Vector *widthtab;
0aa01123 150
228a2e1a
KH
151 if (!VECTORP (buf->width_table))
152 buf->width_table = Fmake_vector (make_number (256), make_number (0));
153 widthtab = XVECTOR (buf->width_table);
0aa01123
JB
154 if (widthtab->size != 256)
155 abort ();
156
157 for (i = 0; i < 256; i++)
228a2e1a 158 XSETFASTINT (widthtab->contents[i], character_width (i, disptab));
0aa01123
JB
159}
160
161/* Allocate or free the width run cache, as requested by the current
162 state of current_buffer's cache_long_line_scans variable. */
88c6e37e 163
0aa01123
JB
164static void
165width_run_cache_on_off ()
166{
a997a7ca
KH
167 if (NILP (current_buffer->cache_long_line_scans)
168 /* And, for the moment, this feature doesn't work on multibyte
169 characters. */
170 || !NILP (current_buffer->enable_multibyte_characters))
0aa01123
JB
171 {
172 /* It should be off. */
173 if (current_buffer->width_run_cache)
174 {
175 free_region_cache (current_buffer->width_run_cache);
176 current_buffer->width_run_cache = 0;
177 current_buffer->width_table = Qnil;
178 }
179 }
180 else
181 {
182 /* It should be on. */
183 if (current_buffer->width_run_cache == 0)
2ff4775b 184 {
0aa01123 185 current_buffer->width_run_cache = new_region_cache ();
0aa01123
JB
186 recompute_width_table (current_buffer, buffer_display_table ());
187 }
188 }
189}
190
191\f
9a21bb64
RS
192/* Skip some invisible characters starting from POS.
193 This includes characters invisible because of text properties
194 and characters invisible because of overlays.
195
196 If position POS is followed by invisible characters,
197 skip some of them and return the position after them.
198 Otherwise return POS itself.
199
200 Set *NEXT_BOUNDARY_P to the next position at which
201 it will be necessary to call this function again.
202
203 Don't scan past TO, and don't set *NEXT_BOUNDARY_P
204 to a value greater than TO.
205
206 If WINDOW is non-nil, and this buffer is displayed in WINDOW,
207 take account of overlays that apply only in WINDOW.
208
209 We don't necessarily skip all the invisible characters after POS
210 because that could take a long time. We skip a reasonable number
211 which can be skipped quickly. If there might be more invisible
212 characters immediately following, then *NEXT_BOUNDARY_P
213 will equal the return value. */
214
8720a429 215int
9a21bb64
RS
216skip_invisible (pos, next_boundary_p, to, window)
217 int pos;
218 int *next_boundary_p;
219 int to;
220 Lisp_Object window;
221{
2e34157c 222 Lisp_Object prop, position, overlay_limit, proplimit;
2ca8b6c2 223 Lisp_Object buffer, tmp;
662152dd 224 int end, inv_p;
9a21bb64
RS
225
226 XSETFASTINT (position, pos);
227 XSETBUFFER (buffer, current_buffer);
228
229 /* Give faster response for overlay lookup near POS. */
230 recenter_overlay_lists (current_buffer, pos);
231
232 /* We must not advance farther than the next overlay change.
233 The overlay change might change the invisible property;
234 or there might be overlay strings to be displayed there. */
235 overlay_limit = Fnext_overlay_change (position);
236 /* As for text properties, this gives a lower bound
237 for where the invisible text property could change. */
238 proplimit = Fnext_property_change (position, buffer, Qt);
239 if (XFASTINT (overlay_limit) < XFASTINT (proplimit))
240 proplimit = overlay_limit;
241 /* PROPLIMIT is now a lower bound for the next change
242 in invisible status. If that is plenty far away,
243 use that lower bound. */
244 if (XFASTINT (proplimit) > pos + 100 || XFASTINT (proplimit) >= to)
245 *next_boundary_p = XFASTINT (proplimit);
246 /* Otherwise, scan for the next `invisible' property change. */
247 else
248 {
249 /* Don't scan terribly far. */
250 XSETFASTINT (proplimit, min (pos + 100, to));
251 /* No matter what. don't go past next overlay change. */
252 if (XFASTINT (overlay_limit) < XFASTINT (proplimit))
253 proplimit = overlay_limit;
2ca8b6c2
SM
254 tmp = Fnext_single_property_change (position, Qinvisible,
255 buffer, proplimit);
256 end = XFASTINT (tmp);
fe0066f5 257#if 0
a997a7ca
KH
258 /* Don't put the boundary in the middle of multibyte form if
259 there is no actual property change. */
260 if (end == pos + 100
261 && !NILP (current_buffer->enable_multibyte_characters)
262 && end < ZV)
263 while (pos < end && !CHAR_HEAD_P (POS_ADDR (end)))
264 end--;
fe0066f5 265#endif
2e34157c 266 *next_boundary_p = end;
9a21bb64
RS
267 }
268 /* if the `invisible' property is set, we can skip to
269 the next property change */
662152dd
SM
270 prop = Fget_char_property (position, Qinvisible,
271 (!NILP (window)
272 && EQ (XWINDOW (window)->buffer, buffer))
273 ? window : buffer);
274 inv_p = TEXT_PROP_MEANS_INVISIBLE (prop);
275 /* When counting columns (window == nil), don't skip over ellipsis text. */
276 if (NILP (window) ? inv_p == 1 : inv_p)
9a21bb64
RS
277 return *next_boundary_p;
278 return pos;
279}
280\f
012fd715 281/* If a composition starts at POS/POS_BYTE and it doesn't stride over
703af3d5 282 POINT, set *LEN / *LEN_BYTE to the character and byte lengths, *WIDTH
012fd715
KH
283 to the width, and return 1. Otherwise, return 0. */
284
285static int
286check_composition (pos, pos_byte, point, len, len_byte, width)
287 int pos, pos_byte, point;
288 int *len, *len_byte, *width;
289{
290 Lisp_Object prop;
291 int start, end;
292 int id;
293
294 if (! find_composition (pos, -1, &start, &end, &prop, Qnil)
9ee6df62
KH
295 || pos != start || point < end
296 || !COMPOSITION_VALID_P (start, end, prop))
012fd715
KH
297 return 0;
298 if ((id = get_composition_id (pos, pos_byte, end - pos, prop, Qnil)) < 0)
299 return 0;
300
301 *len = COMPOSITION_LENGTH (prop);
302 *len_byte = CHAR_TO_BYTE (end) - pos_byte;
303 *width = composition_table[id]->width;
304 return 1;
305}
306\f
c9c0f7cf
KH
307/* Set variables WIDTH and BYTES for a multibyte sequence starting at P.
308
c9c0f7cf
KH
309 DP is a display table or NULL.
310
311 This macro is used in current_column_1, Fmove_to_column, and
312 compute_motion. */
313
012fd715
KH
314#define MULTIBYTE_BYTES_WIDTH(p, dp) \
315 do { \
316 int c; \
317 \
318 wide_column = 0; \
319 c = STRING_CHAR_AND_LENGTH (p, MAX_MULTIBYTE_LENGTH, bytes); \
320 if (BYTES_BY_CHAR_HEAD (*p) != bytes) \
321 width = bytes * 4; \
322 else \
323 { \
324 if (dp != 0 && VECTORP (DISP_CHAR_VECTOR (dp, c))) \
325 width = XVECTOR (DISP_CHAR_VECTOR (dp, c))->size; \
326 else \
327 width = WIDTH_BY_CHAR_HEAD (*p); \
328 if (width > 1) \
329 wide_column = width; \
330 } \
c9c0f7cf
KH
331 } while (0)
332
097812fb 333
993b6404 334DEFUN ("current-column", Fcurrent_column, Scurrent_column, 0, 0, 0,
8c1a1077
PJ
335 doc: /* Return the horizontal position of point. Beginning of line is column 0.
336This is calculated by adding together the widths of all the displayed
337representations of the character between the start of the previous line
7bf120f1
JB
338and point (eg. control characters will have a width of 2 or 4, tabs
339will have a variable width).
8c1a1077
PJ
340Ignores finite width of frame, which means that this function may return
341values greater than (frame-width).
342Whether the line is visible (if `selective-display' is t) has no effect;
e01732fa
SM
343however, ^M is treated as end of line when `selective-display' is t.
344Text that has an invisible property is considered as having width 0, unless
345`buffer-invisibility-spec' specifies that it is replaced by an ellipsis. */)
8c1a1077 346 ()
993b6404
JB
347{
348 Lisp_Object temp;
097812fb 349 XSETFASTINT (temp, (int) current_column ()); /* iftc */
993b6404
JB
350 return temp;
351}
352
e74928fc
JB
353/* Cancel any recorded value of the horizontal position. */
354
c9667ae1 355void
e74928fc
JB
356invalidate_current_column ()
357{
358 last_known_column_point = 0;
359}
360
76e20cb0 361double
993b6404
JB
362current_column ()
363{
364 register int col;
365 register unsigned char *ptr, *stop;
366 register int tab_seen;
367 int post_tab;
368 register int c;
369 register int tab_width = XINT (current_buffer->tab_width);
56a98455 370 int ctl_arrow = !NILP (current_buffer->ctl_arrow);
d44f12b4 371 register struct Lisp_Char_Table *dp = buffer_display_table ();
993b6404 372
6ec8bbd2 373 if (PT == last_known_column_point
993b6404
JB
374 && MODIFF == last_known_column_modified)
375 return last_known_column;
376
813b81b3
RS
377 /* If the buffer has overlays, text properties,
378 or multibyte characters, use a more general algorithm. */
9a21bb64 379 if (BUF_INTERVALS (current_buffer)
3ea2f6f3
SM
380 || current_buffer->overlays_before
381 || current_buffer->overlays_after
813b81b3
RS
382 || Z != Z_BYTE)
383 return current_column_1 ();
9a21bb64
RS
384
385 /* Scan backwards from point to the previous newline,
386 counting width. Tab characters are the only complicated case. */
387
993b6404 388 /* Make a pointer for decrementing through the chars before point. */
fe0066f5 389 ptr = BYTE_POS_ADDR (PT_BYTE - 1) + 1;
993b6404
JB
390 /* Make a pointer to where consecutive chars leave off,
391 going backwards from point. */
6ec8bbd2 392 if (PT == BEGV)
993b6404 393 stop = ptr;
6ec8bbd2 394 else if (PT <= GPT || BEGV > GPT)
993b6404
JB
395 stop = BEGV_ADDR;
396 else
397 stop = GAP_END_ADDR;
398
88c6e37e
GM
399 if (tab_width <= 0 || tab_width > 1000)
400 tab_width = 8;
993b6404
JB
401
402 col = 0, tab_seen = 0, post_tab = 0;
403
404 while (1)
405 {
88c6e37e
GM
406 EMACS_INT i, n;
407 Lisp_Object charvec;
097812fb 408
993b6404
JB
409 if (ptr == stop)
410 {
411 /* We stopped either for the beginning of the buffer
412 or for the gap. */
413 if (ptr == BEGV_ADDR)
414 break;
097812fb 415
993b6404
JB
416 /* It was the gap. Jump back over it. */
417 stop = BEGV_ADDR;
418 ptr = GPT_ADDR;
097812fb 419
993b6404 420 /* Check whether that brings us to beginning of buffer. */
88c6e37e
GM
421 if (BEGV >= GPT)
422 break;
993b6404
JB
423 }
424
425 c = *--ptr;
097812fb 426
88c6e37e 427 if (dp && VECTORP (DISP_CHAR_VECTOR (dp, c)))
7050d530 428 {
88c6e37e
GM
429 charvec = DISP_CHAR_VECTOR (dp, c);
430 n = ASIZE (charvec);
7050d530 431 }
88c6e37e 432 else
993b6404 433 {
88c6e37e
GM
434 charvec = Qnil;
435 n = 1;
436 }
097812fb 437
88c6e37e
GM
438 for (i = n - 1; i >= 0; --i)
439 {
440 if (VECTORP (charvec))
441 {
442 /* This should be handled the same as
443 next_element_from_display_vector does it. */
444 Lisp_Object entry = AREF (charvec, i);
097812fb 445
88c6e37e
GM
446 if (INTEGERP (entry)
447 && GLYPH_CHAR_VALID_P (XFASTINT (entry)))
448 c = FAST_GLYPH_CHAR (XFASTINT (entry));
449 else
450 c = ' ';
451 }
097812fb 452
88c6e37e
GM
453 if (c >= 040 && c < 0177)
454 col++;
455 else if (c == '\n'
456 || (c == '\r'
457 && EQ (current_buffer->selective_display, Qt)))
458 {
459 ptr++;
460 goto start_of_line_found;
461 }
462 else if (c == '\t')
463 {
464 if (tab_seen)
465 col = ((col + tab_width) / tab_width) * tab_width;
097812fb 466
88c6e37e
GM
467 post_tab += col;
468 col = 0;
469 tab_seen = 1;
470 }
f1004faf
GM
471 else if (VECTORP (charvec))
472 /* With a display table entry, C is displayed as is, and
473 not displayed as \NNN or as ^N. If C is a single-byte
474 character, it takes one column. If C is multi-byte in
475 an unibyte buffer, it's translated to unibyte, so it
476 also takes one column. */
477 ++col;
88c6e37e
GM
478 else
479 col += (ctl_arrow && c < 0200) ? 2 : 4;
993b6404 480 }
993b6404
JB
481 }
482
88c6e37e
GM
483 start_of_line_found:
484
993b6404
JB
485 if (tab_seen)
486 {
487 col = ((col + tab_width) / tab_width) * tab_width;
488 col += post_tab;
489 }
490
a997a7ca
KH
491 if (ptr == BEGV_ADDR)
492 current_column_bol_cache = BEGV;
493 else
fe0066f5
RS
494 current_column_bol_cache = BYTE_TO_CHAR (PTR_BYTE_POS (ptr));
495
993b6404 496 last_known_column = col;
6ec8bbd2 497 last_known_column_point = PT;
993b6404
JB
498 last_known_column_modified = MODIFF;
499
500 return col;
501}
502\f
9a21bb64
RS
503/* Return the column number of position POS
504 by scanning forward from the beginning of the line.
505 This function handles characters that are invisible
506 due to text properties or overlays. */
507
76e20cb0 508static double
813b81b3 509current_column_1 ()
9a21bb64
RS
510{
511 register int tab_width = XINT (current_buffer->tab_width);
512 register int ctl_arrow = !NILP (current_buffer->ctl_arrow);
513 register struct Lisp_Char_Table *dp = buffer_display_table ();
fe0066f5 514 int multibyte = !NILP (current_buffer->enable_multibyte_characters);
9a21bb64
RS
515
516 /* Start the scan at the beginning of this line with column number 0. */
517 register int col = 0;
fe0066f5 518 int scan, scan_byte;
58b1103e 519 int next_boundary;
fe0066f5
RS
520 int opoint = PT, opoint_byte = PT_BYTE;
521
813b81b3 522 scan_newline (PT, PT_BYTE, BEGV, BEGV_BYTE, -1, 1);
fe0066f5
RS
523 current_column_bol_cache = PT;
524 scan = PT, scan_byte = PT_BYTE;
525 SET_PT_BOTH (opoint, opoint_byte);
526 next_boundary = scan;
9a21bb64
RS
527
528 if (tab_width <= 0 || tab_width > 1000) tab_width = 8;
529
530 /* Scan forward to the target position. */
813b81b3 531 while (scan < opoint)
9a21bb64
RS
532 {
533 int c;
534
535 /* Occasionally we may need to skip invisible text. */
536 while (scan == next_boundary)
537 {
fe0066f5 538 int old_scan = scan;
9a21bb64
RS
539 /* This updates NEXT_BOUNDARY to the next place
540 where we might need to skip more invisible text. */
813b81b3
RS
541 scan = skip_invisible (scan, &next_boundary, opoint, Qnil);
542 if (scan >= opoint)
9a21bb64 543 goto endloop;
fe0066f5
RS
544 if (scan != old_scan)
545 scan_byte = CHAR_TO_BYTE (scan);
9a21bb64
RS
546 }
547
012fd715
KH
548 /* Check composition sequence. */
549 {
550 int len, len_byte, width;
551
552 if (check_composition (scan, scan_byte, opoint,
553 &len, &len_byte, &width))
554 {
555 scan += len;
556 scan_byte += len_byte;
557 if (scan <= opoint)
558 col += width;
559 continue;
560 }
561 }
562
813b81b3 563 c = FETCH_BYTE (scan_byte);
88c6e37e 564
c9c0f7cf
KH
565 if (dp != 0
566 && ! (multibyte && BASE_LEADING_CODE_P (c))
567 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
9a21bb64 568 {
d6e483a4
RS
569 Lisp_Object charvec;
570 EMACS_INT i, n;
571
572 /* This character is displayed using a vector of glyphs.
573 Update the column based on those glyphs. */
574
88c6e37e
GM
575 charvec = DISP_CHAR_VECTOR (dp, c);
576 n = ASIZE (charvec);
88c6e37e 577
d6e483a4 578 for (i = 0; i < n; i++)
88c6e37e
GM
579 {
580 /* This should be handled the same as
581 next_element_from_display_vector does it. */
d6e483a4
RS
582 Lisp_Object entry;
583 entry = AREF (charvec, i);
584
88c6e37e
GM
585 if (INTEGERP (entry)
586 && GLYPH_CHAR_VALID_P (XFASTINT (entry)))
587 c = FAST_GLYPH_CHAR (XFASTINT (entry));
588 else
589 c = ' ';
d6e483a4
RS
590
591 if (c == '\n')
592 goto endloop;
593 if (c == '\r' && EQ (current_buffer->selective_display, Qt))
594 goto endloop;
595 if (c == '\t')
596 {
d6e483a4
RS
597 col += tab_width;
598 col = col / tab_width * tab_width;
599 }
600 else
601 ++col;
88c6e37e 602 }
d6e483a4
RS
603 }
604 else
605 {
606 /* The display table says nothing for this character.
607 Display it as itself. */
608
88c6e37e
GM
609 if (c == '\n')
610 goto endloop;
611 if (c == '\r' && EQ (current_buffer->selective_display, Qt))
612 goto endloop;
88c6e37e
GM
613 if (c == '\t')
614 {
88c6e37e
GM
615 col += tab_width;
616 col = col / tab_width * tab_width;
617 }
618 else if (multibyte && BASE_LEADING_CODE_P (c))
619 {
620 unsigned char *ptr;
621 int bytes, width, wide_column;
097812fb 622
88c6e37e
GM
623 ptr = BYTE_POS_ADDR (scan_byte);
624 MULTIBYTE_BYTES_WIDTH (ptr, dp);
625 scan_byte += bytes;
36974b5e
RS
626 /* Subtract one to compensate for the increment
627 that is going to happen below. */
628 scan_byte--;
88c6e37e
GM
629 col += width;
630 }
631 else if (ctl_arrow && (c < 040 || c == 0177))
632 col += 2;
633 else if (c < 040 || c >= 0177)
634 col += 4;
635 else
636 col++;
a997a7ca 637 }
d6e483a4
RS
638 scan++;
639 scan_byte++;
640
9a21bb64
RS
641 }
642 endloop:
643
644 last_known_column = col;
6ec8bbd2 645 last_known_column_point = PT;
9a21bb64
RS
646 last_known_column_modified = MODIFF;
647
648 return col;
649}
650\f
f4a6687d
GM
651
652#if 0 /* Not used. */
653
c412c808
RS
654/* Return the width in columns of the part of STRING from BEG to END.
655 If BEG is nil, that stands for the beginning of STRING.
656 If END is nil, that stands for the end of STRING. */
657
76e20cb0 658static double
382ac0bd 659string_display_width (string, beg, end)
c412c808
RS
660 Lisp_Object string, beg, end;
661{
662 register int col;
663 register unsigned char *ptr, *stop;
664 register int tab_seen;
665 int post_tab;
666 register int c;
667 register int tab_width = XINT (current_buffer->tab_width);
668 int ctl_arrow = !NILP (current_buffer->ctl_arrow);
d44f12b4 669 register struct Lisp_Char_Table *dp = buffer_display_table ();
c412c808
RS
670 int b, e;
671
672 if (NILP (end))
d5db4077 673 e = SCHARS (string);
c412c808
RS
674 else
675 {
b7826503 676 CHECK_NUMBER (end);
c412c808
RS
677 e = XINT (end);
678 }
679
680 if (NILP (beg))
681 b = 0;
682 else
683 {
b7826503 684 CHECK_NUMBER (beg);
c412c808
RS
685 b = XINT (beg);
686 }
687
688 /* Make a pointer for decrementing through the chars before point. */
d5db4077 689 ptr = SDATA (string) + e;
c412c808
RS
690 /* Make a pointer to where consecutive chars leave off,
691 going backwards from point. */
d5db4077 692 stop = SDATA (string) + b;
c412c808
RS
693
694 if (tab_width <= 0 || tab_width > 1000) tab_width = 8;
695
696 col = 0, tab_seen = 0, post_tab = 0;
697
698 while (1)
699 {
700 if (ptr == stop)
701 break;
702
703 c = *--ptr;
704 if (dp != 0 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
705 col += XVECTOR (DISP_CHAR_VECTOR (dp, c))->size;
706 else if (c >= 040 && c < 0177)
707 col++;
708 else if (c == '\n')
709 break;
710 else if (c == '\t')
711 {
712 if (tab_seen)
713 col = ((col + tab_width) / tab_width) * tab_width;
714
715 post_tab += col;
716 col = 0;
717 tab_seen = 1;
718 }
719 else
720 col += (ctl_arrow && c < 0200) ? 2 : 4;
721 }
722
723 if (tab_seen)
724 {
725 col = ((col + tab_width) / tab_width) * tab_width;
726 col += post_tab;
727 }
728
729 return col;
730}
f4a6687d
GM
731
732#endif /* 0 */
733
c412c808 734\f
993b6404 735DEFUN ("indent-to", Findent_to, Sindent_to, 1, 2, "NIndent to column: ",
8c1a1077 736 doc: /* Indent from point with tabs and spaces until COLUMN is reached.
7bf120f1 737Optional second argument MINIMUM says always do at least MINIMUM spaces
f64f035e
EZ
738even if that goes past COLUMN; by default, MINIMUM is zero.
739
740The return value is COLUMN. */)
8c1a1077 741 (column, minimum)
04c98432 742 Lisp_Object column, minimum;
993b6404
JB
743{
744 int mincol;
745 register int fromcol;
746 register int tab_width = XINT (current_buffer->tab_width);
747
b7826503 748 CHECK_NUMBER (column);
56a98455 749 if (NILP (minimum))
94d92e9c 750 XSETFASTINT (minimum, 0);
b7826503 751 CHECK_NUMBER (minimum);
993b6404
JB
752
753 fromcol = current_column ();
754 mincol = fromcol + XINT (minimum);
04c98432 755 if (mincol < XINT (column)) mincol = XINT (column);
993b6404
JB
756
757 if (fromcol == mincol)
758 return make_number (mincol);
759
ccdcf1f5 760 if (tab_width <= 0 || tab_width > 1000) tab_width = 8;
993b6404
JB
761
762 if (indent_tabs_mode)
763 {
764 Lisp_Object n;
94d92e9c 765 XSETFASTINT (n, mincol / tab_width - fromcol / tab_width);
993b6404
JB
766 if (XFASTINT (n) != 0)
767 {
6d1bd1a5 768 Finsert_char (make_number ('\t'), n, Qt);
993b6404
JB
769
770 fromcol = (mincol / tab_width) * tab_width;
771 }
772 }
773
04c98432
EN
774 XSETFASTINT (column, mincol - fromcol);
775 Finsert_char (make_number (' '), column, Qt);
993b6404
JB
776
777 last_known_column = mincol;
6ec8bbd2 778 last_known_column_point = PT;
993b6404
JB
779 last_known_column_modified = MODIFF;
780
04c98432
EN
781 XSETINT (column, mincol);
782 return column;
993b6404 783}
0aa01123 784
993b6404 785\f
76e20cb0 786static double position_indentation P_ ((int));
dfcf069d 787
993b6404 788DEFUN ("current-indentation", Fcurrent_indentation, Scurrent_indentation,
8c1a1077
PJ
789 0, 0, 0,
790 doc: /* Return the indentation of the current line.
791This is the horizontal position of the character
792following any initial whitespace. */)
793 ()
993b6404
JB
794{
795 Lisp_Object val;
fe0066f5
RS
796 int opoint = PT, opoint_byte = PT_BYTE;
797
798 scan_newline (PT, PT_BYTE, BEGV, BEGV_BYTE, -1, 1);
993b6404 799
097812fb 800 XSETFASTINT (val, (int) position_indentation (PT_BYTE)); /* iftc */
fe0066f5 801 SET_PT_BOTH (opoint, opoint_byte);
993b6404
JB
802 return val;
803}
804
76e20cb0 805static double
fe0066f5
RS
806position_indentation (pos_byte)
807 register int pos_byte;
993b6404
JB
808{
809 register int column = 0;
810 register int tab_width = XINT (current_buffer->tab_width);
811 register unsigned char *p;
812 register unsigned char *stop;
9a21bb64 813 unsigned char *start;
fe0066f5
RS
814 int next_boundary_byte = pos_byte;
815 int ceiling = next_boundary_byte;
2ff4775b 816
ccdcf1f5 817 if (tab_width <= 0 || tab_width > 1000) tab_width = 8;
2ff4775b 818
fe0066f5 819 p = BYTE_POS_ADDR (pos_byte);
9a21bb64
RS
820 /* STOP records the value of P at which we will need
821 to think about the gap, or about invisible text,
822 or about the end of the buffer. */
823 stop = p;
824 /* START records the starting value of P. */
825 start = p;
993b6404
JB
826 while (1)
827 {
828 while (p == stop)
829 {
fe0066f5 830 int stop_pos_byte;
9a21bb64 831
fe0066f5
RS
832 /* If we have updated P, set POS_BYTE to match.
833 The first time we enter the loop, POS_BYTE is already right. */
9a21bb64 834 if (p != start)
fe0066f5 835 pos_byte = PTR_BYTE_POS (p);
9a21bb64 836 /* Consider the various reasons STOP might have been set here. */
fe0066f5 837 if (pos_byte == ZV_BYTE)
993b6404 838 return column;
fe0066f5
RS
839 if (pos_byte == next_boundary_byte)
840 {
841 int next_boundary;
842 int pos = BYTE_TO_CHAR (pos_byte);
843 pos = skip_invisible (pos, &next_boundary, ZV, Qnil);
844 pos_byte = CHAR_TO_BYTE (pos);
845 next_boundary_byte = CHAR_TO_BYTE (next_boundary);
846 }
847 if (pos_byte >= ceiling)
848 ceiling = BUFFER_CEILING_OF (pos_byte) + 1;
9a21bb64
RS
849 /* Compute the next place we need to stop and think,
850 and set STOP accordingly. */
fe0066f5 851 stop_pos_byte = min (ceiling, next_boundary_byte);
9a21bb64 852 /* The -1 and +1 arrange to point at the first byte of gap
fe0066f5 853 (if STOP_POS_BYTE is the position of the gap)
9a21bb64 854 rather than at the data after the gap. */
097812fb 855
fe0066f5
RS
856 stop = BYTE_POS_ADDR (stop_pos_byte - 1) + 1;
857 p = BYTE_POS_ADDR (pos_byte);
993b6404
JB
858 }
859 switch (*p++)
860 {
fb911777
KH
861 case 0240:
862 if (! NILP (current_buffer->enable_multibyte_characters))
863 return column;
993b6404
JB
864 case ' ':
865 column++;
866 break;
867 case '\t':
868 column += tab_width - column % tab_width;
869 break;
870 default:
fb911777
KH
871 if (ASCII_BYTE_P (p[-1])
872 || NILP (current_buffer->enable_multibyte_characters))
873 return column;
874 {
fe0066f5
RS
875 int c;
876 pos_byte = PTR_BYTE_POS (p - 1);
877 c = FETCH_MULTIBYTE_CHAR (pos_byte);
fb911777
KH
878 if (CHAR_HAS_CATEGORY (c, ' '))
879 {
880 column++;
fe0066f5
RS
881 INC_POS (pos_byte);
882 p = BYTE_POS_ADDR (pos_byte);
fb911777
KH
883 }
884 else
885 return column;
886 }
993b6404
JB
887 }
888 }
889}
1b15e576
KH
890
891/* Test whether the line beginning at POS is indented beyond COLUMN.
892 Blank lines are treated as if they had the same indentation as the
893 preceding line. */
fe0066f5 894
1b15e576 895int
fe0066f5 896indented_beyond_p (pos, pos_byte, column)
097812fb 897 int pos, pos_byte;
76e20cb0 898 double column;
1b15e576 899{
76e20cb0 900 double val;
fe0066f5
RS
901 int opoint = PT, opoint_byte = PT_BYTE;
902
903 SET_PT_BOTH (pos, pos_byte);
904 while (PT > BEGV && FETCH_BYTE (PT_BYTE) == '\n')
905 scan_newline (PT - 1, PT_BYTE - 1, BEGV, BEGV_BYTE, -1, 0);
906
d5d6f706 907 val = position_indentation (PT_BYTE);
fe0066f5 908 SET_PT_BOTH (opoint, opoint_byte);
097812fb 909 return val >= column; /* hmm, float comparison */
1b15e576 910}
993b6404 911\f
782d260e 912DEFUN ("move-to-column", Fmove_to_column, Smove_to_column, 1, 2, "p",
8c1a1077 913 doc: /* Move point to column COLUMN in the current line.
3c860543 914Interactively, COLUMN is the value of prefix numeric argument.
8c1a1077
PJ
915The column of a character is calculated by adding together the widths
916as displayed of the previous characters in the line.
917This function ignores line-continuation;
918there is no upper limit on the column number a character can have
919and horizontal scrolling has no effect.
920
921If specified column is within a character, point goes after that character.
922If it's past end of line, point goes to end of line.
923
3c860543
EZ
924Optional second argument FORCE non-nil means if COLUMN is in the
925middle of a tab character, change it to spaces.
926In addition, if FORCE is t, and the line is too short to reach
927COLUMN, add spaces/tabs to get there.
8c1a1077
PJ
928
929The return value is the current column. */)
930 (column, force)
993b6404
JB
931 Lisp_Object column, force;
932{
933 register int pos;
934 register int col = current_column ();
935 register int goal;
936 register int end;
937 register int tab_width = XINT (current_buffer->tab_width);
56a98455 938 register int ctl_arrow = !NILP (current_buffer->ctl_arrow);
d44f12b4 939 register struct Lisp_Char_Table *dp = buffer_display_table ();
a997a7ca 940 register int multibyte = !NILP (current_buffer->enable_multibyte_characters);
993b6404
JB
941
942 Lisp_Object val;
6bbd7a29
GM
943 int prev_col = 0;
944 int c = 0;
58b1103e 945 int next_boundary, pos_byte;
fe0066f5 946
ccdcf1f5 947 if (tab_width <= 0 || tab_width > 1000) tab_width = 8;
b7826503 948 CHECK_NATNUM (column);
993b6404
JB
949 goal = XINT (column);
950
6ec8bbd2 951 pos = PT;
fe0066f5 952 pos_byte = PT_BYTE;
993b6404
JB
953 end = ZV;
954
955 /* If we're starting past the desired column,
956 back up to beginning of line and scan from there. */
957 if (col > goal)
958 {
9a21bb64 959 end = pos;
a997a7ca 960 pos = current_column_bol_cache;
fe0066f5 961 pos_byte = CHAR_TO_BYTE (pos);
993b6404
JB
962 col = 0;
963 }
964
4c669c09
RS
965 next_boundary = pos;
966
8861f16f 967 while (pos < end)
993b6404 968 {
9a21bb64
RS
969 while (pos == next_boundary)
970 {
fe0066f5 971 int prev = pos;
9a21bb64 972 pos = skip_invisible (pos, &next_boundary, end, Qnil);
fe0066f5
RS
973 if (pos != prev)
974 pos_byte = CHAR_TO_BYTE (pos);
9a21bb64
RS
975 if (pos >= end)
976 goto endloop;
977 }
978
8861f16f
RS
979 /* Test reaching the goal column. We do this after skipping
980 invisible characters, so that we put point before the
981 character on which the cursor will appear. */
982 if (col >= goal)
983 break;
984
012fd715
KH
985 /* Check composition sequence. */
986 {
987 int len, len_byte, width;
988
989 if (check_composition (pos, pos_byte, Z, &len, &len_byte, &width))
990 {
991 pos += len;
992 pos_byte += len_byte;
993 col += width;
994 continue;
995 }
996 }
997
fe0066f5 998 c = FETCH_BYTE (pos_byte);
88c6e37e 999
d6e483a4
RS
1000 /* See if there is a display table and it relates
1001 to this character. */
1002
c9c0f7cf
KH
1003 if (dp != 0
1004 && ! (multibyte && BASE_LEADING_CODE_P (c))
1005 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
f845b8b2 1006 {
d6e483a4
RS
1007 Lisp_Object charvec;
1008 EMACS_INT i, n;
1009
1010 /* This character is displayed using a vector of glyphs.
1011 Update the position based on those glyphs. */
1012
88c6e37e
GM
1013 charvec = DISP_CHAR_VECTOR (dp, c);
1014 n = ASIZE (charvec);
88c6e37e 1015
d6e483a4 1016 for (i = 0; i < n; i++)
88c6e37e
GM
1017 {
1018 /* This should be handled the same as
1019 next_element_from_display_vector does it. */
d6e483a4
RS
1020
1021 Lisp_Object entry;
1022 entry = AREF (charvec, i);
1023
88c6e37e
GM
1024 if (INTEGERP (entry)
1025 && GLYPH_CHAR_VALID_P (XFASTINT (entry)))
1026 c = FAST_GLYPH_CHAR (XFASTINT (entry));
1027 else
1028 c = ' ';
d6e483a4
RS
1029
1030 if (c == '\n')
1031 goto endloop;
1032 if (c == '\r' && EQ (current_buffer->selective_display, Qt))
1033 goto endloop;
1034 if (c == '\t')
1035 {
1036 prev_col = col;
1037 col += tab_width;
1038 col = col / tab_width * tab_width;
1039 }
1040 else
1041 ++col;
88c6e37e 1042 }
d6e483a4
RS
1043 }
1044 else
1045 {
1046 /* The display table doesn't affect this character;
1047 it displays as itself. */
88c6e37e 1048
88c6e37e
GM
1049 if (c == '\n')
1050 goto endloop;
1051 if (c == '\r' && EQ (current_buffer->selective_display, Qt))
1052 goto endloop;
88c6e37e
GM
1053 if (c == '\t')
1054 {
1055 prev_col = col;
1056 col += tab_width;
1057 col = col / tab_width * tab_width;
1058 }
1059 else if (ctl_arrow && (c < 040 || c == 0177))
1060 col += 2;
1061 else if (c < 040 || c == 0177)
1062 col += 4;
1063 else if (c < 0177)
1064 col++;
1065 else if (multibyte && BASE_LEADING_CODE_P (c))
1066 {
1067 /* Start of multi-byte form. */
1068 unsigned char *ptr;
1069 int bytes, width, wide_column;
1070
88c6e37e
GM
1071 ptr = BYTE_POS_ADDR (pos_byte);
1072 MULTIBYTE_BYTES_WIDTH (ptr, dp);
d6e483a4 1073 pos_byte += bytes - 1;
88c6e37e
GM
1074 col += width;
1075 }
1076 else
1077 col += 4;
a997a7ca 1078 }
d6e483a4
RS
1079
1080 pos++;
1081 pos_byte++;
993b6404 1082 }
9a21bb64 1083 endloop:
993b6404 1084
fe0066f5 1085 SET_PT_BOTH (pos, pos_byte);
993b6404
JB
1086
1087 /* If a tab char made us overshoot, change it to spaces
1088 and scan through it again. */
56a98455 1089 if (!NILP (force) && col > goal && c == '\t' && prev_col < goal)
993b6404 1090 {
154a424a
GM
1091 int goal_pt, goal_pt_byte;
1092
1093 /* Insert spaces in front of the tab to reach GOAL. Do this
1094 first so that a marker at the end of the tab gets
1095 adjusted. */
1096 SET_PT_BOTH (PT - 1, PT_BYTE - 1);
1097 Finsert_char (make_number (' '), make_number (goal - prev_col), Qt);
1098
1099 /* Now delete the tab, and indent to COL. */
1100 del_range (PT, PT + 1);
1101 goal_pt = PT;
1102 goal_pt_byte = PT_BYTE;
70ee42f7 1103 Findent_to (make_number (col), Qnil);
154a424a 1104 SET_PT_BOTH (goal_pt, goal_pt_byte);
097812fb 1105
5a05d3d2
RS
1106 /* Set the last_known... vars consistently. */
1107 col = goal;
993b6404
JB
1108 }
1109
1110 /* If line ends prematurely, add space to the end. */
de4075cf 1111 if (col < goal && EQ (force, Qt))
230a4cbd 1112 Findent_to (make_number (col = goal), Qnil);
993b6404
JB
1113
1114 last_known_column = col;
6ec8bbd2 1115 last_known_column_point = PT;
993b6404
JB
1116 last_known_column_modified = MODIFF;
1117
94d92e9c 1118 XSETFASTINT (val, col);
993b6404
JB
1119 return val;
1120}
1121\f
0aa01123
JB
1122/* compute_motion: compute buffer posn given screen posn and vice versa */
1123
993b6404
JB
1124struct position val_compute_motion;
1125
1126/* Scan the current buffer forward from offset FROM, pretending that
1127 this is at line FROMVPOS, column FROMHPOS, until reaching buffer
1128 offset TO or line TOVPOS, column TOHPOS (whichever comes first),
0aa01123
JB
1129 and return the ending buffer position and screen location. If we
1130 can't hit the requested column exactly (because of a tab or other
1131 multi-column character), overshoot.
993b6404 1132
2ab90d49
KH
1133 DID_MOTION is 1 if FROMHPOS has already accounted for overlay strings
1134 at FROM. This is the case if FROMVPOS and FROMVPOS came from an
1135 earlier call to compute_motion. The other common case is that FROMHPOS
1136 is zero and FROM is a position that "belongs" at column zero, but might
1137 be shifted by overlay strings; in this case DID_MOTION should be 0.
1138
993b6404
JB
1139 WIDTH is the number of columns available to display text;
1140 compute_motion uses this to handle continuation lines and such.
361f14bf
KS
1141 If WIDTH is -1, use width of window's text area adjusted for
1142 continuation glyph when needed.
1143
993b6404
JB
1144 HSCROLL is the number of columns not being displayed at the left
1145 margin; this is usually taken from a window's hscroll member.
a9764248
JB
1146 TAB_OFFSET is the number of columns of the first tab that aren't
1147 being displayed, perhaps because of a continuation line or
1148 something.
993b6404
JB
1149
1150 compute_motion returns a pointer to a struct position. The bufpos
1151 member gives the buffer position at the end of the scan, and hpos
0aa01123
JB
1152 and vpos give its cartesian location. prevhpos is the column at
1153 which the character before bufpos started, and contin is non-zero
1154 if we reached the current line by continuing the previous.
1155
1156 Note that FROMHPOS and TOHPOS should be expressed in real screen
1157 columns, taking HSCROLL and the truncation glyph at the left margin
1158 into account. That is, beginning-of-line moves you to the hpos
1159 -HSCROLL + (HSCROLL > 0).
993b6404
JB
1160
1161 For example, to find the buffer position of column COL of line LINE
1162 of a certain window, pass the window's starting location as FROM
1163 and the window's upper-left coordinates as FROMVPOS and FROMHPOS.
1164 Pass the buffer's ZV as TO, to limit the scan to the end of the
1165 visible section of the buffer, and pass LINE and COL as TOVPOS and
2ff4775b 1166 TOHPOS.
993b6404
JB
1167
1168 When displaying in window w, a typical formula for WIDTH is:
1169
1170 window_width - 1
a3c87d4e 1171 - (has_vertical_scroll_bars
90022f5a
KS
1172 ? WINDOW_CONFIG_SCROLL_BAR_COLS (window)
1173 : (window_width + window_left != frame_cols))
993b6404
JB
1174
1175 where
90022f5a
KS
1176 window_width is XFASTINT (w->total_cols),
1177 window_left is XFASTINT (w->left_col),
a3c87d4e 1178 has_vertical_scroll_bars is
90022f5a
KS
1179 WINDOW_HAS_VERTICAL_SCROLL_BAR (window)
1180 and frame_cols = FRAME_COLS (XFRAME (window->frame))
993b6404 1181
90022f5a
KS
1182 Or you can let window_box_text_cols do this all for you, and write:
1183 window_box_text_cols (w) - 1
fa61c701
JB
1184
1185 The `-1' accounts for the continuation-line backslashes; the rest
7e7a76b5 1186 accounts for window borders if the window is split horizontally, and
1827d036 1187 the scroll bars if they are turned on. */
993b6404
JB
1188
1189struct position *
2ab90d49 1190compute_motion (from, fromvpos, fromhpos, did_motion, to, tovpos, tohpos, width, hscroll, tab_offset, win)
993b6404 1191 int from, fromvpos, fromhpos, to, tovpos, tohpos;
2ab90d49 1192 int did_motion;
993b6404
JB
1193 register int width;
1194 int hscroll, tab_offset;
88af3af4 1195 struct window *win;
993b6404 1196{
cde9337b
JB
1197 register int hpos = fromhpos;
1198 register int vpos = fromvpos;
1199
993b6404 1200 register int pos;
fe0066f5 1201 int pos_byte;
6bbd7a29 1202 register int c = 0;
993b6404 1203 register int tab_width = XFASTINT (current_buffer->tab_width);
56a98455 1204 register int ctl_arrow = !NILP (current_buffer->ctl_arrow);
d44f12b4 1205 register struct Lisp_Char_Table *dp = window_display_table (win);
993b6404 1206 int selective
eeaafd4f 1207 = (INTEGERP (current_buffer->selective_display)
69eaf10d
RS
1208 ? XINT (current_buffer->selective_display)
1209 : !NILP (current_buffer->selective_display) ? -1 : 0);
993b6404 1210 int selective_rlen
eeaafd4f 1211 = (selective && dp && VECTORP (DISP_INVIS_VECTOR (dp))
dea4d2e6 1212 ? XVECTOR (DISP_INVIS_VECTOR (dp))->size : 0);
2ab90d49
KH
1213 /* The next location where the `invisible' property changes, or an
1214 overlay starts or ends. */
1215 int next_boundary = from;
993b6404 1216
0aa01123
JB
1217 /* For computing runs of characters with similar widths.
1218 Invariant: width_run_width is zero, or all the characters
2ff4775b 1219 from width_run_start to width_run_end have a fixed width of
0aa01123
JB
1220 width_run_width. */
1221 int width_run_start = from;
1222 int width_run_end = from;
1223 int width_run_width = 0;
1224 Lisp_Object *width_table;
66c75ca5 1225 Lisp_Object buffer;
0aa01123
JB
1226
1227 /* The next buffer pos where we should consult the width run cache. */
1228 int next_width_run = from;
0e435804 1229 Lisp_Object window;
0aa01123 1230
a997a7ca 1231 int multibyte = !NILP (current_buffer->enable_multibyte_characters);
c71c19f4
RS
1232 /* If previous char scanned was a wide character,
1233 this is the column where it ended. Otherwise, this is 0. */
1234 int wide_column_end_hpos = 0;
a997a7ca 1235 int prev_pos; /* Previous buffer position. */
fe0066f5 1236 int prev_pos_byte; /* Previous buffer position. */
357589bf
RS
1237 int prev_hpos = 0;
1238 int prev_vpos = 0;
a997a7ca
KH
1239 int contin_hpos; /* HPOS of last column of continued line. */
1240 int prev_tab_offset; /* Previous tab offset. */
ed5c373c 1241 int continuation_glyph_width;
a997a7ca 1242
66c75ca5 1243 XSETBUFFER (buffer, current_buffer);
0e435804 1244 XSETWINDOW (window, win);
66c75ca5 1245
0aa01123
JB
1246 width_run_cache_on_off ();
1247 if (dp == buffer_display_table ())
1248 width_table = (VECTORP (current_buffer->width_table)
1249 ? XVECTOR (current_buffer->width_table)->contents
1250 : 0);
1251 else
1252 /* If the window has its own display table, we can't use the width
1253 run cache, because that's based on the buffer's display table. */
1254 width_table = 0;
1255
e4500116
GM
1256 if (tab_width <= 0 || tab_width > 1000)
1257 tab_width = 8;
1258
361f14bf
KS
1259 /* Negative width means use all available text columns. */
1260 if (width < 0)
1261 {
1262 width = window_box_text_cols (win);
1263 /* We must make room for continuation marks if we don't have fringes. */
1264#ifdef HAVE_WINDOW_SYSTEM
1265 if (!FRAME_WINDOW_P (XFRAME (win->frame)))
1266#endif
1267 width -= 1;
1268 }
1269
8cc08515 1270 continuation_glyph_width = 1;
ed5c373c 1271#ifdef HAVE_WINDOW_SYSTEM
8cc08515
KS
1272 if (FRAME_WINDOW_P (XFRAME (win->frame)))
1273 continuation_glyph_width = 0; /* In the fringe. */
ed5c373c
KS
1274#endif
1275
e4500116
GM
1276 immediate_quit = 1;
1277 QUIT;
cde9337b 1278
a997a7ca 1279 pos = prev_pos = from;
fe0066f5 1280 pos_byte = prev_pos_byte = CHAR_TO_BYTE (from);
a997a7ca
KH
1281 contin_hpos = 0;
1282 prev_tab_offset = tab_offset;
2ab90d49
KH
1283 while (1)
1284 {
1285 while (pos == next_boundary)
f75c0f8a 1286 {
fe0066f5 1287 int pos_here = pos;
98136db3
RS
1288 int newpos;
1289
f9ba10b0 1290 /* Don't skip invisible if we are already at the margin. */
8a00d895 1291 if (vpos > tovpos || (vpos == tovpos && hpos >= tohpos))
f9ba10b0
RS
1292 {
1293 if (contin_hpos && prev_hpos == 0
1294 && hpos > tohpos
1295 && (contin_hpos == width || wide_column_end_hpos > width))
1296 { /* Line breaks because we can't put the character at the
1297 previous line any more. It is not the multi-column
1298 character continued in middle. Go back to previous
1299 buffer position, screen position, and set tab offset
1300 to previous value. It's the beginning of the
1301 line. */
1302 pos = prev_pos;
1303 pos_byte = prev_pos_byte;
1304 hpos = prev_hpos;
357589bf 1305 vpos = prev_vpos;
f9ba10b0
RS
1306 tab_offset = prev_tab_offset;
1307 }
1308 break;
1309 }
1310
2ab90d49
KH
1311 /* If the caller says that the screen position came from an earlier
1312 call to compute_motion, then we've already accounted for the
1313 overlay strings at point. This is only true the first time
1314 through, so clear the flag after testing it. */
1315 if (!did_motion)
1316 /* We need to skip past the overlay strings. Currently those
a997a7ca 1317 strings must not contain TAB;
2ab90d49
KH
1318 if we want to relax that restriction, something will have
1319 to be changed here. */
a997a7ca
KH
1320 {
1321 unsigned char *ovstr;
1322 int ovlen = overlay_strings (pos, win, &ovstr);
4116deee
KH
1323 hpos += ((multibyte && ovlen > 0)
1324 ? strwidth (ovstr, ovlen) : ovlen);
a997a7ca 1325 }
2ab90d49
KH
1326 did_motion = 0;
1327
1328 if (pos >= to)
1329 break;
66c75ca5 1330
9a21bb64
RS
1331 /* Advance POS past invisible characters
1332 (but not necessarily all that there are here),
1333 and store in next_boundary the next position where
1334 we need to call skip_invisible. */
98136db3
RS
1335 newpos = skip_invisible (pos, &next_boundary, to, window);
1336
1337 if (newpos >= to)
e8cb089b
RS
1338 {
1339 pos = min (to, newpos);
bcfbd63d 1340 pos_byte = CHAR_TO_BYTE (pos);
e8cb089b
RS
1341 goto after_loop;
1342 }
98136db3 1343
fe0066f5
RS
1344 if (newpos != pos_here)
1345 {
1346 pos = newpos;
1347 pos_byte = CHAR_TO_BYTE (pos);
1348 }
f75c0f8a 1349 }
2ab90d49
KH
1350
1351 /* Handle right margin. */
a997a7ca
KH
1352 /* Note on a wide-column character.
1353
1354 Characters are classified into the following three categories
1355 according to the width (columns occupied on screen).
1356
1357 (1) single-column character: ex. `a'
1358 (2) multi-column character: ex. `^A', TAB, `\033'
1359 (3) wide-column character: ex. Japanese character, Chinese character
1360 (In the following example, `W_' stands for them.)
1361
1362 Multi-column characters can be divided around the right margin,
1363 but wide-column characters cannot.
1364
1365 NOTE:
1366
1367 (*) The cursor is placed on the next character after the point.
1368
1369 ----------
1370 abcdefghi\
1371 j ^---- next after the point
1372 ^--- next char. after the point.
1373 ----------
1374 In case of sigle-column character
1375
1376 ----------
1377 abcdefgh\\
1378 033 ^---- next after the point, next char. after the point.
1379 ----------
1380 In case of multi-column character
1381
1382 ----------
1383 abcdefgh\\
1384 W_ ^---- next after the point
1385 ^---- next char. after the point.
1386 ----------
097812fb 1387 In case of wide-column character
a997a7ca
KH
1388
1389 The problem here is continuation at a wide-column character.
1390 In this case, the line may shorter less than WIDTH.
1391 And we find the continuation AFTER it occurs.
1392
1393 */
1394
1395 if (hpos > width)
2ab90d49
KH
1396 {
1397 if (hscroll
1398 || (truncate_partial_width_windows
ed5c373c
KS
1399 && ((width + continuation_glyph_width)
1400 < FRAME_COLS (XFRAME (WINDOW_FRAME (win)))))
2ab90d49
KH
1401 || !NILP (current_buffer->truncate_lines))
1402 {
529724fe
AS
1403 /* Truncating: skip to newline, unless we are already past
1404 TO (we need to go back below). */
1405 if (pos <= to)
fe0066f5
RS
1406 {
1407 pos = find_before_next_newline (pos, to, 1);
1408 pos_byte = CHAR_TO_BYTE (pos);
529724fe
AS
1409 hpos = width;
1410 /* If we just skipped next_boundary,
1411 loop around in the main while
1412 and handle it. */
1413 if (pos >= next_boundary)
1414 next_boundary = pos + 1;
1415 prev_hpos = width;
357589bf 1416 prev_vpos = vpos;
529724fe 1417 prev_tab_offset = tab_offset;
fe0066f5 1418 }
2ab90d49
KH
1419 }
1420 else
1421 {
1422 /* Continuing. */
a997a7ca
KH
1423 /* Remember the previous value. */
1424 prev_tab_offset = tab_offset;
1425
c9c0f7cf 1426 if (wide_column_end_hpos > width)
a997a7ca
KH
1427 {
1428 hpos -= prev_hpos;
1429 tab_offset += prev_hpos;
1430 }
1431 else
1432 {
1433 tab_offset += width;
1434 hpos -= width;
1435 }
1436 vpos++;
1437 contin_hpos = prev_hpos;
1438 prev_hpos = 0;
6cbc951e 1439 prev_vpos = vpos;
2ab90d49
KH
1440 }
1441 }
1442
1443 /* Stop if past the target buffer position or screen position. */
33fe7d20 1444 if (pos > to)
a997a7ca
KH
1445 {
1446 /* Go back to the previous position. */
1447 pos = prev_pos;
fe0066f5 1448 pos_byte = prev_pos_byte;
a997a7ca 1449 hpos = prev_hpos;
357589bf 1450 vpos = prev_vpos;
a997a7ca
KH
1451 tab_offset = prev_tab_offset;
1452
1453 /* NOTE on contin_hpos, hpos, and prev_hpos.
1454
1455 ----------
1456 abcdefgh\\
1457 W_ ^---- contin_hpos
1458 | ^----- hpos
1459 \---- prev_hpos
1460 ----------
1461 */
1462
1463 if (contin_hpos && prev_hpos == 0
c9c0f7cf 1464 && contin_hpos < width && !wide_column_end_hpos)
a997a7ca
KH
1465 {
1466 /* Line breaking occurs in the middle of multi-column
1467 character. Go back to previous line. */
1468 hpos = contin_hpos;
1469 vpos = vpos - 1;
1470 }
a997a7ca
KH
1471 break;
1472 }
1473
8a00d895 1474 if (vpos > tovpos || (vpos == tovpos && hpos >= tohpos))
33fe7d20
RS
1475 {
1476 if (contin_hpos && prev_hpos == 0
9129bcc3
KH
1477 && hpos > tohpos
1478 && (contin_hpos == width || wide_column_end_hpos > width))
33fe7d20
RS
1479 { /* Line breaks because we can't put the character at the
1480 previous line any more. It is not the multi-column
1481 character continued in middle. Go back to previous
1482 buffer position, screen position, and set tab offset
1483 to previous value. It's the beginning of the
1484 line. */
1485 pos = prev_pos;
1486 pos_byte = prev_pos_byte;
1487 hpos = prev_hpos;
357589bf 1488 vpos = prev_vpos;
33fe7d20
RS
1489 tab_offset = prev_tab_offset;
1490 }
1491 break;
1492 }
a997a7ca 1493 if (pos == ZV) /* We cannot go beyond ZV. Stop here. */
2ab90d49
KH
1494 break;
1495
2ab90d49 1496 prev_hpos = hpos;
357589bf 1497 prev_vpos = vpos;
a997a7ca 1498 prev_pos = pos;
fe0066f5 1499 prev_pos_byte = pos_byte;
c9c0f7cf 1500 wide_column_end_hpos = 0;
0aa01123
JB
1501
1502 /* Consult the width run cache to see if we can avoid inspecting
1503 the text character-by-character. */
1504 if (current_buffer->width_run_cache && pos >= next_width_run)
1505 {
1506 int run_end;
1507 int common_width
1508 = region_cache_forward (current_buffer,
1509 current_buffer->width_run_cache,
1510 pos, &run_end);
1511
1512 /* A width of zero means the character's width varies (like
1513 a tab), is meaningless (like a newline), or we just don't
1514 want to skip over it for some other reason. */
1515 if (common_width != 0)
1516 {
1517 int run_end_hpos;
1518
1519 /* Don't go past the final buffer posn the user
1520 requested. */
1521 if (run_end > to)
1522 run_end = to;
1523
1524 run_end_hpos = hpos + (run_end - pos) * common_width;
1525
1526 /* Don't go past the final horizontal position the user
1527 requested. */
1528 if (vpos == tovpos && run_end_hpos > tohpos)
1529 {
1530 run_end = pos + (tohpos - hpos) / common_width;
1531 run_end_hpos = hpos + (run_end - pos) * common_width;
1532 }
2ff4775b 1533
0aa01123
JB
1534 /* Don't go past the margin. */
1535 if (run_end_hpos >= width)
1536 {
1537 run_end = pos + (width - hpos) / common_width;
1538 run_end_hpos = hpos + (run_end - pos) * common_width;
1539 }
1540
1541 hpos = run_end_hpos;
1542 if (run_end > pos)
1543 prev_hpos = hpos - common_width;
fe0066f5
RS
1544 if (pos != run_end)
1545 {
1546 pos = run_end;
1547 pos_byte = CHAR_TO_BYTE (pos);
1548 }
0aa01123
JB
1549 }
1550
1551 next_width_run = run_end + 1;
1552 }
1553
1554 /* We have to scan the text character-by-character. */
993b6404 1555 else
2ab90d49 1556 {
88c6e37e
GM
1557 EMACS_INT i, n;
1558 Lisp_Object charvec;
097812fb 1559
fe0066f5 1560 c = FETCH_BYTE (pos_byte);
012fd715
KH
1561
1562 /* Check composition sequence. */
1563 {
1564 int len, len_byte, width;
1565
1566 if (check_composition (pos, pos_byte, to, &len, &len_byte, &width))
1567 {
1568 pos += len;
1569 pos_byte += len_byte;
1570 hpos += width;
1571 continue;
1572 }
1573 }
1574
fe0066f5 1575 pos++, pos_byte++;
0aa01123 1576
2ab90d49
KH
1577 /* Perhaps add some info to the width_run_cache. */
1578 if (current_buffer->width_run_cache)
1579 {
1580 /* Is this character part of the current run? If so, extend
1581 the run. */
1582 if (pos - 1 == width_run_end
5db0afb7 1583 && XFASTINT (width_table[c]) == width_run_width)
2ab90d49
KH
1584 width_run_end = pos;
1585
1586 /* The previous run is over, since this is a character at a
1587 different position, or a different width. */
1588 else
1589 {
1590 /* Have we accumulated a run to put in the cache?
1591 (Currently, we only cache runs of width == 1). */
1592 if (width_run_start < width_run_end
1593 && width_run_width == 1)
1594 know_region_cache (current_buffer,
1595 current_buffer->width_run_cache,
1596 width_run_start, width_run_end);
1597
1598 /* Start recording a new width run. */
5db0afb7 1599 width_run_width = XFASTINT (width_table[c]);
2ab90d49
KH
1600 width_run_start = pos - 1;
1601 width_run_end = pos;
1602 }
1603 }
993b6404 1604
c9c0f7cf
KH
1605 if (dp != 0
1606 && ! (multibyte && BASE_LEADING_CODE_P (c))
1607 && VECTORP (DISP_CHAR_VECTOR (dp, c)))
993b6404 1608 {
88c6e37e
GM
1609 charvec = DISP_CHAR_VECTOR (dp, c);
1610 n = ASIZE (charvec);
993b6404 1611 }
88c6e37e 1612 else
993b6404 1613 {
88c6e37e
GM
1614 charvec = Qnil;
1615 n = 1;
1616 }
1617
1618 for (i = n - 1; i >= 0; --i)
1619 {
1620 if (VECTORP (charvec))
2ab90d49 1621 {
88c6e37e
GM
1622 /* This should be handled the same as
1623 next_element_from_display_vector does it. */
1624 Lisp_Object entry = AREF (charvec, i);
097812fb 1625
88c6e37e
GM
1626 if (INTEGERP (entry)
1627 && GLYPH_CHAR_VALID_P (XFASTINT (entry)))
1628 c = FAST_GLYPH_CHAR (XFASTINT (entry));
1629 else
1630 c = ' ';
1631 }
097812fb 1632
88c6e37e
GM
1633 if (c >= 040 && c < 0177)
1634 hpos++;
1635 else if (c == '\t')
1636 {
1637 int tem = ((hpos + tab_offset + hscroll - (hscroll > 0))
1638 % tab_width);
1639 if (tem < 0)
1640 tem += tab_width;
1641 hpos += tab_width - tem;
1642 }
1643 else if (c == '\n')
1644 {
1645 if (selective > 0
097812fb 1646 && indented_beyond_p (pos, pos_byte,
76e20cb0 1647 (double) selective)) /* iftc */
2ab90d49 1648 {
88c6e37e
GM
1649 /* If (pos == to), we don't have to take care of
1650 selective display. */
1651 if (pos < to)
fe0066f5 1652 {
88c6e37e
GM
1653 /* Skip any number of invisible lines all at once */
1654 do
1655 {
1656 pos = find_before_next_newline (pos, to, 1);
1657 if (pos < to)
1658 pos++;
1659 pos_byte = CHAR_TO_BYTE (pos);
1660 }
1661 while (pos < to
097812fb 1662 && indented_beyond_p (pos, pos_byte,
76e20cb0 1663 (double) selective)); /* iftc */
88c6e37e
GM
1664 /* Allow for the " ..." that is displayed for them. */
1665 if (selective_rlen)
1666 {
1667 hpos += selective_rlen;
1668 if (hpos >= width)
1669 hpos = width;
1670 }
1671 DEC_BOTH (pos, pos_byte);
1672 /* We have skipped the invis text, but not the
1673 newline after. */
fe0066f5 1674 }
2ab90d49 1675 }
88c6e37e
GM
1676 else
1677 {
1678 /* A visible line. */
1679 vpos++;
1680 hpos = 0;
1681 hpos -= hscroll;
1682 /* Count the truncation glyph on column 0 */
1683 if (hscroll > 0)
ed5c373c 1684 hpos += continuation_glyph_width;
88c6e37e
GM
1685 tab_offset = 0;
1686 }
1687 contin_hpos = 0;
2ab90d49 1688 }
88c6e37e 1689 else if (c == CR && selective < 0)
fe0066f5 1690 {
88c6e37e
GM
1691 /* In selective display mode,
1692 everything from a ^M to the end of the line is invisible.
1693 Stop *before* the real newline. */
1694 if (pos < to)
1695 {
1696 pos = find_before_next_newline (pos, to, 1);
1697 pos_byte = CHAR_TO_BYTE (pos);
1698 }
1699 /* If we just skipped next_boundary,
1700 loop around in the main while
1701 and handle it. */
1702 if (pos > next_boundary)
1703 next_boundary = pos;
1704 /* Allow for the " ..." that is displayed for them. */
1705 if (selective_rlen)
1706 {
1707 hpos += selective_rlen;
1708 if (hpos >= width)
1709 hpos = width;
1710 }
fe0066f5 1711 }
88c6e37e 1712 else if (multibyte && BASE_LEADING_CODE_P (c))
2ab90d49 1713 {
88c6e37e
GM
1714 /* Start of multi-byte form. */
1715 unsigned char *ptr;
1716 int bytes, width, wide_column;
1717
1718 pos_byte--; /* rewind POS_BYTE */
1719 ptr = BYTE_POS_ADDR (pos_byte);
1720 MULTIBYTE_BYTES_WIDTH (ptr, dp);
1721 pos_byte += bytes;
1722 if (wide_column)
1723 wide_column_end_hpos = hpos + wide_column;
1724 hpos += width;
2ab90d49 1725 }
f1004faf
GM
1726 else if (VECTORP (charvec))
1727 ++hpos;
88c6e37e
GM
1728 else
1729 hpos += (ctl_arrow && c < 0200) ? 2 : 4;
2ab90d49 1730 }
993b6404
JB
1731 }
1732 }
1733
98136db3
RS
1734 after_loop:
1735
0aa01123
JB
1736 /* Remember any final width run in the cache. */
1737 if (current_buffer->width_run_cache
1738 && width_run_width == 1
1739 && width_run_start < width_run_end)
1740 know_region_cache (current_buffer, current_buffer->width_run_cache,
1741 width_run_start, width_run_end);
1742
993b6404 1743 val_compute_motion.bufpos = pos;
fe0066f5 1744 val_compute_motion.bytepos = pos_byte;
cde9337b
JB
1745 val_compute_motion.hpos = hpos;
1746 val_compute_motion.vpos = vpos;
ef3af330
AS
1747 if (contin_hpos && prev_hpos == 0)
1748 val_compute_motion.prevhpos = contin_hpos;
1749 else
1750 val_compute_motion.prevhpos = prev_hpos;
927b5a55
RS
1751 /* We alalways handle all of them here; none of them remain to do. */
1752 val_compute_motion.ovstring_chars_done = 0;
993b6404
JB
1753
1754 /* Nonzero if have just continued a line */
a997a7ca 1755 val_compute_motion.contin = (contin_hpos && prev_hpos == 0);
993b6404 1756
e4500116 1757 immediate_quit = 0;
993b6404
JB
1758 return &val_compute_motion;
1759}
993b6404 1760
8720a429 1761
88af3af4 1762DEFUN ("compute-motion", Fcompute_motion, Scompute_motion, 7, 7, 0,
8c1a1077
PJ
1763 doc: /* Scan through the current buffer, calculating screen position.
1764Scan the current buffer forward from offset FROM,
1765assuming it is at position FROMPOS--a cons of the form (HPOS . VPOS)--
1766to position TO or position TOPOS--another cons of the form (HPOS . VPOS)--
1767and return the ending buffer position and screen location.
1768
361f14bf
KS
1769If TOPOS is nil, the actual width and height of the window's
1770text area are used.
1771
8c1a1077
PJ
1772There are three additional arguments:
1773
1774WIDTH is the number of columns available to display text;
361f14bf
KS
1775this affects handling of continuation lines. A value of nil
1776corresponds to the actual number of available text columns.
8c1a1077
PJ
1777
1778OFFSETS is either nil or a cons cell (HSCROLL . TAB-OFFSET).
1779HSCROLL is the number of columns not being displayed at the left
1780margin; this is usually taken from a window's hscroll member.
1781TAB-OFFSET is the number of columns of the first tab that aren't
1782being displayed, perhaps because the line was continued within it.
1783If OFFSETS is nil, HSCROLL and TAB-OFFSET are assumed to be zero.
1784
1785WINDOW is the window to operate on. It is used to choose the display table;
1786if it is showing the current buffer, it is used also for
1787deciding which overlay properties apply.
1788Note that `compute-motion' always operates on the current buffer.
1789
1790The value is a list of five elements:
1791 (POS HPOS VPOS PREVHPOS CONTIN)
1792POS is the buffer position where the scan stopped.
1793VPOS is the vertical position where the scan stopped.
1794HPOS is the horizontal position where the scan stopped.
1795
1796PREVHPOS is the horizontal position one character back from POS.
1797CONTIN is t if a line was continued after (or within) the previous character.
1798
1799For example, to find the buffer position of column COL of line LINE
1800of a certain window, pass the window's starting location as FROM
1801and the window's upper-left coordinates as FROMPOS.
1802Pass the buffer's (point-max) as TO, to limit the scan to the end of the
1803visible section of the buffer, and pass LINE and COL as TOPOS. */)
1804 (from, frompos, to, topos, width, offsets, window)
42918ba5 1805 Lisp_Object from, frompos, to, topos;
88af3af4 1806 Lisp_Object width, offsets, window;
42918ba5 1807{
361f14bf 1808 struct window *w;
8798a92b 1809 Lisp_Object bufpos, hpos, vpos, prevhpos;
42918ba5
RS
1810 struct position *pos;
1811 int hscroll, tab_offset;
1812
b7826503
PJ
1813 CHECK_NUMBER_COERCE_MARKER (from);
1814 CHECK_CONS (frompos);
1815 CHECK_NUMBER_CAR (frompos);
1816 CHECK_NUMBER_CDR (frompos);
1817 CHECK_NUMBER_COERCE_MARKER (to);
361f14bf
KS
1818 if (!NILP (topos))
1819 {
1820 CHECK_CONS (topos);
1821 CHECK_NUMBER_CAR (topos);
1822 CHECK_NUMBER_CDR (topos);
1823 }
1824 if (!NILP (width))
1825 CHECK_NUMBER (width);
1826
42918ba5
RS
1827 if (!NILP (offsets))
1828 {
b7826503
PJ
1829 CHECK_CONS (offsets);
1830 CHECK_NUMBER_CAR (offsets);
1831 CHECK_NUMBER_CDR (offsets);
70949dac
KR
1832 hscroll = XINT (XCAR (offsets));
1833 tab_offset = XINT (XCDR (offsets));
42918ba5
RS
1834 }
1835 else
1836 hscroll = tab_offset = 0;
1837
88af3af4
KH
1838 if (NILP (window))
1839 window = Fselected_window ();
1840 else
b7826503 1841 CHECK_LIVE_WINDOW (window);
361f14bf 1842 w = XWINDOW (window);
88af3af4 1843
9fdae274
KH
1844 if (XINT (from) < BEGV || XINT (from) > ZV)
1845 args_out_of_range_3 (from, make_number (BEGV), make_number (ZV));
1846 if (XINT (to) < BEGV || XINT (to) > ZV)
1847 args_out_of_range_3 (to, make_number (BEGV), make_number (ZV));
1848
70949dac
KR
1849 pos = compute_motion (XINT (from), XINT (XCDR (frompos)),
1850 XINT (XCAR (frompos)), 0,
361f14bf
KS
1851 XINT (to),
1852 (NILP (topos)
1853 ? window_internal_height (w)
1854 : XINT (XCDR (topos))),
1855 (NILP (topos)
1856 ? (window_box_text_cols (w)
1857 - (
1858#ifdef HAVE_WINDOW_SYSTEM
1859 FRAME_WINDOW_P (XFRAME (w->frame)) ? 0 :
1860#endif
1861 1))
1862 : XINT (XCAR (topos))),
1863 (NILP (width) ? -1 : XINT (width)),
1864 hscroll, tab_offset,
88af3af4 1865 XWINDOW (window));
42918ba5 1866
94d92e9c 1867 XSETFASTINT (bufpos, pos->bufpos);
f8f645a1
KH
1868 XSETINT (hpos, pos->hpos);
1869 XSETINT (vpos, pos->vpos);
1870 XSETINT (prevhpos, pos->prevhpos);
42918ba5
RS
1871
1872 return Fcons (bufpos,
1873 Fcons (hpos,
1874 Fcons (vpos,
1875 Fcons (prevhpos,
1876 Fcons (pos->contin ? Qt : Qnil, Qnil)))));
1877
1878}
993b6404 1879\f
0aa01123 1880/* Fvertical_motion and vmotion */
88c6e37e 1881
993b6404
JB
1882struct position val_vmotion;
1883
1884struct position *
99ce22d5
KH
1885vmotion (from, vtarget, w)
1886 register int from, vtarget;
1887 struct window *w;
993b6404 1888{
99ce22d5 1889 int hscroll = XINT (w->hscroll);
993b6404
JB
1890 struct position pos;
1891 /* vpos is cumulative vertical position, changed as from is changed */
1892 register int vpos = 0;
2965dff9 1893 int prevline;
993b6404 1894 register int first;
fe0066f5 1895 int from_byte;
993b6404
JB
1896 int lmargin = hscroll > 0 ? 1 - hscroll : 0;
1897 int selective
eeaafd4f
KH
1898 = (INTEGERP (current_buffer->selective_display)
1899 ? XINT (current_buffer->selective_display)
1900 : !NILP (current_buffer->selective_display) ? -1 : 0);
99ce22d5
KH
1901 Lisp_Object window;
1902 int start_hpos = 0;
2ab90d49 1903 int did_motion;
7ac57cb3
RS
1904 /* This is the object we use for fetching character properties. */
1905 Lisp_Object text_prop_object;
99ce22d5
KH
1906
1907 XSETWINDOW (window, w);
1908
7ac57cb3
RS
1909 /* If the window contains this buffer, use it for getting text properties.
1910 Otherwise use the current buffer as arg for doing that. */
1911 if (EQ (w->buffer, Fcurrent_buffer ()))
1912 text_prop_object = window;
1913 else
1914 text_prop_object = Fcurrent_buffer ();
1915
99ce22d5 1916 if (vpos >= vtarget)
993b6404 1917 {
99ce22d5 1918 /* To move upward, go a line at a time until
fe0066f5 1919 we have gone at least far enough. */
99ce22d5
KH
1920
1921 first = 1;
1922
1923 while ((vpos > vtarget || first) && from > BEGV)
993b6404 1924 {
66c75ca5
RS
1925 Lisp_Object propval;
1926
2965dff9
RS
1927 prevline = find_next_newline_no_quit (from - 1, -1);
1928 while (prevline > BEGV
5a05d3d2 1929 && ((selective > 0
2965dff9
RS
1930 && indented_beyond_p (prevline,
1931 CHAR_TO_BYTE (prevline),
76e20cb0 1932 (double) selective)) /* iftc */
2965dff9
RS
1933 /* Watch out for newlines with `invisible' property.
1934 When moving upward, check the newline before. */
1935 || (propval = Fget_char_property (make_number (prevline - 1),
66c75ca5 1936 Qinvisible,
7ac57cb3 1937 text_prop_object),
339ee979 1938 TEXT_PROP_MEANS_INVISIBLE (propval))))
2965dff9
RS
1939 prevline = find_next_newline_no_quit (prevline - 1, -1);
1940 pos = *compute_motion (prevline, 0,
1941 lmargin + (prevline == BEG ? start_hpos : 0),
2ab90d49 1942 0,
097812fb 1943 from,
a997a7ca
KH
1944 /* Don't care for VPOS... */
1945 1 << (BITS_PER_SHORT - 1),
1946 /* ... nor HPOS. */
1947 1 << (BITS_PER_SHORT - 1),
361f14bf 1948 -1, hscroll,
2dd4e608
RS
1949 /* This compensates for start_hpos
1950 so that a tab as first character
1951 still occupies 8 columns. */
2965dff9 1952 (prevline == BEG ? -start_hpos : 0),
2dd4e608 1953 w);
99ce22d5
KH
1954 vpos -= pos.vpos;
1955 first = 0;
2965dff9 1956 from = prevline;
993b6404 1957 }
99ce22d5
KH
1958
1959 /* If we made exactly the desired vertical distance,
1960 or if we hit beginning of buffer,
1961 return point found */
1962 if (vpos >= vtarget)
993b6404 1963 {
99ce22d5 1964 val_vmotion.bufpos = from;
fe0066f5 1965 val_vmotion.bytepos = CHAR_TO_BYTE (from);
99ce22d5
KH
1966 val_vmotion.vpos = vpos;
1967 val_vmotion.hpos = lmargin;
1968 val_vmotion.contin = 0;
1969 val_vmotion.prevhpos = 0;
927b5a55 1970 val_vmotion.ovstring_chars_done = 0;
a997a7ca 1971 val_vmotion.tab_offset = 0; /* For accumulating tab offset. */
99ce22d5 1972 return &val_vmotion;
993b6404 1973 }
993b6404 1974
99ce22d5
KH
1975 /* Otherwise find the correct spot by moving down */
1976 }
1977 /* Moving downward is simple, but must calculate from beg of line
1978 to determine hpos of starting point */
fe0066f5
RS
1979 from_byte = CHAR_TO_BYTE (from);
1980 if (from > BEGV && FETCH_BYTE (from_byte - 1) != '\n')
993b6404 1981 {
2ab90d49 1982 Lisp_Object propval;
66c75ca5 1983
2965dff9
RS
1984 prevline = find_next_newline_no_quit (from, -1);
1985 while (prevline > BEGV
99ce22d5 1986 && ((selective > 0
2965dff9
RS
1987 && indented_beyond_p (prevline,
1988 CHAR_TO_BYTE (prevline),
76e20cb0 1989 (double) selective)) /* iftc */
2965dff9
RS
1990 /* Watch out for newlines with `invisible' property.
1991 When moving downward, check the newline after. */
1992 || (propval = Fget_char_property (make_number (prevline),
1993 Qinvisible,
7ac57cb3 1994 text_prop_object),
339ee979 1995 TEXT_PROP_MEANS_INVISIBLE (propval))))
2965dff9
RS
1996 prevline = find_next_newline_no_quit (prevline - 1, -1);
1997 pos = *compute_motion (prevline, 0,
1998 lmargin + (prevline == BEG
92992c7e 1999 ? start_hpos : 0),
2ab90d49 2000 0,
097812fb 2001 from,
a997a7ca
KH
2002 /* Don't care for VPOS... */
2003 1 << (BITS_PER_SHORT - 1),
2004 /* ... nor HPOS. */
2005 1 << (BITS_PER_SHORT - 1),
361f14bf 2006 -1, hscroll,
2965dff9 2007 (prevline == BEG ? -start_hpos : 0),
2dd4e608 2008 w);
2ab90d49 2009 did_motion = 1;
993b6404 2010 }
99ce22d5 2011 else
993b6404 2012 {
99ce22d5
KH
2013 pos.hpos = lmargin + (from == BEG ? start_hpos : 0);
2014 pos.vpos = 0;
a997a7ca 2015 pos.tab_offset = 0;
2ab90d49 2016 did_motion = 0;
993b6404 2017 }
2ab90d49 2018 return compute_motion (from, vpos, pos.hpos, did_motion,
a997a7ca 2019 ZV, vtarget, - (1 << (BITS_PER_SHORT - 1)),
361f14bf 2020 -1, hscroll,
a997a7ca 2021 pos.tab_offset - (from == BEG ? start_hpos : 0),
2dd4e608 2022 w);
993b6404
JB
2023}
2024
f1ecfe9b 2025DEFUN ("vertical-motion", Fvertical_motion, Svertical_motion, 1, 2, 0,
8c1a1077
PJ
2026 doc: /* Move point to start of the screen line LINES lines down.
2027If LINES is negative, this means moving up.
2028
2029This function is an ordinary cursor motion function
2030which calculates the new position based on how text would be displayed.
2031The new position may be the start of a line,
2032or just the start of a continuation line.
2033The function returns number of screen lines moved over;
2034that usually equals LINES, but may be closer to zero
2035if beginning or end of buffer was reached.
2036
2037The optional second argument WINDOW specifies the window to use for
2038parameters such as width, horizontal scrolling, and so on.
2039The default is to use the selected window's parameters.
2040
2041`vertical-motion' always uses the current buffer,
2042regardless of which buffer is displayed in WINDOW.
2043This is consistent with other cursor motion functions
2044and makes it possible to use `vertical-motion' in any buffer,
2045whether or not it is currently displayed in some window. */)
2046 (lines, window)
f1ecfe9b 2047 Lisp_Object lines, window;
993b6404 2048{
8720a429
GM
2049 struct it it;
2050 struct text_pos pt;
8720a429 2051 struct window *w;
39210e90
GM
2052 Lisp_Object old_buffer;
2053 struct gcpro gcpro1;
993b6404 2054
b7826503 2055 CHECK_NUMBER (lines);
f1ecfe9b 2056 if (! NILP (window))
b7826503 2057 CHECK_WINDOW (window);
f1ecfe9b 2058 else
92992c7e 2059 window = selected_window;
8720a429 2060 w = XWINDOW (window);
39210e90
GM
2061
2062 old_buffer = Qnil;
2063 GCPRO1 (old_buffer);
2064 if (XBUFFER (w->buffer) != current_buffer)
8720a429 2065 {
39210e90
GM
2066 /* Set the window's buffer temporarily to the current buffer. */
2067 old_buffer = w->buffer;
2068 XSETBUFFER (w->buffer, current_buffer);
8720a429 2069 }
097812fb 2070
6df71429 2071 if (noninteractive)
9305b0e7 2072 {
6df71429
RS
2073 struct position pos;
2074 pos = *vmotion (PT, XINT (lines), w);
2075 SET_PT_BOTH (pos.bufpos, pos.bytepos);
9305b0e7
KS
2076 }
2077 else
6df71429 2078 {
24a06d04 2079 int it_start;
8fd7aa51 2080 int oselective;
9e313cc1 2081 int it_overshoot_expected;
24a06d04 2082
6df71429
RS
2083 SET_TEXT_POS (pt, PT, PT_BYTE);
2084 start_display (&it, w, pt);
2085
2086 /* Scan from the start of the line containing PT. If we don't
2087 do this, we start moving with IT->current_x == 0, while PT is
2088 really at some x > 0. The effect is, in continuation lines, that
2089 we end up with the iterator placed at where it thinks X is 0,
2090 while the end position is really at some X > 0, the same X that
2091 PT had. */
24a06d04 2092 it_start = IT_CHARPOS (it);
14a7cabf
CY
2093
2094 /* We expect the call to move_it_to, further down, to overshoot
cec726f6
KH
2095 if the starting point is on an image, stretch glyph,
2096 composition, or Lisp string. We won't need to backtrack in
2097 this situation, except for one corner case: when the Lisp
2098 string contains a newline. */
14a7cabf
CY
2099 if (it.method == GET_FROM_STRING)
2100 {
2101 const char *s = SDATA (it.string);
2102 const char *e = s + SBYTES (it.string);
2103
2104 while (s < e && *s != '\n')
2105 ++s;
2106
9e313cc1
KS
2107 /* If there is no newline in the string, we need to check
2108 whether there is a newline immediately after the string
2109 in move_it_to below. This may happen if there is an
2110 overlay with an after-string just before the newline. */
2111 it_overshoot_expected = (s == e) ? -1 : 0;
14a7cabf
CY
2112 }
2113 else
9e313cc1
KS
2114 it_overshoot_expected = (it.method == GET_FROM_IMAGE
2115 || it.method == GET_FROM_STRETCH
2116 || it.method == GET_FROM_COMPOSITION);
14a7cabf 2117
b54a7539
KS
2118 reseat_at_previous_visible_line_start (&it);
2119 it.current_x = it.hpos = 0;
8fd7aa51
KS
2120 /* Temporarily disable selective display so we don't move too far */
2121 oselective = it.selective;
2122 it.selective = 0;
b54a7539 2123 move_it_to (&it, PT, -1, -1, -1, MOVE_TO_POS);
8fd7aa51 2124 it.selective = oselective;
b54a7539
KS
2125
2126 /* Move back if we got too far. This may happen if
0163a0d5 2127 truncate-lines is on and PT is beyond right margin.
14a7cabf 2128 Don't go back if the overshoot is expected (see above). */
e2de7999 2129 if (IT_CHARPOS (it) > it_start && XINT (lines) > 0
9e313cc1
KS
2130 && (!it_overshoot_expected
2131 || (it_overshoot_expected < 0
2132 && it.method == GET_FROM_BUFFER
2133 && it.c == '\n')))
b54a7539 2134 move_it_by_lines (&it, -1, 0);
3a46a5de 2135
b54a7539 2136 it.vpos = 0;
5bf3adc1
RS
2137 /* Do this even if LINES is 0, so that we move back
2138 to the beginning of the current line as we ought. */
78744fc3
KS
2139 if (XINT (lines) >= 0 || IT_CHARPOS (it) > 0)
2140 move_it_by_lines (&it, XINT (lines), 0);
097812fb 2141
6df71429
RS
2142 SET_PT_BOTH (IT_CHARPOS (it), IT_BYTEPOS (it));
2143 }
8720a429 2144
39210e90
GM
2145 if (BUFFERP (old_buffer))
2146 w->buffer = old_buffer;
097812fb 2147
39210e90 2148 RETURN_UNGCPRO (make_number (it.vpos));
993b6404 2149}
8720a429
GM
2150
2151
993b6404 2152\f
88c6e37e 2153/* File's initialization. */
0aa01123 2154
dfcf069d 2155void
993b6404
JB
2156syms_of_indent ()
2157{
2158 DEFVAR_BOOL ("indent-tabs-mode", &indent_tabs_mode,
8c1a1077
PJ
2159 doc: /* *Indentation can insert tabs if this is non-nil.
2160Setting this variable automatically makes it local to the current buffer. */);
993b6404
JB
2161 indent_tabs_mode = 1;
2162
2163 defsubr (&Scurrent_indentation);
2164 defsubr (&Sindent_to);
2165 defsubr (&Scurrent_column);
2166 defsubr (&Smove_to_column);
2167 defsubr (&Svertical_motion);
42918ba5 2168 defsubr (&Scompute_motion);
993b6404 2169}
ab5796a9
MB
2170
2171/* arch-tag: 9adfea44-71f7-4988-8ee3-96da15c502cc
2172 (do not change this comment) */