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