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