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