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