xdisp.c 155 KB
Newer Older
Jim Blandy's avatar
Jim Blandy committed
1
/* Display generation from window structure and buffer text.
2 3
   Copyright (C) 1985, 86, 87, 88, 93, 94, 95, 1997
     Free Software Foundation, Inc.
Jim Blandy's avatar
Jim Blandy committed
4 5 6 7 8

This file is part of GNU Emacs.

GNU Emacs is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
9
the Free Software Foundation; either version 2, or (at your option)
Jim Blandy's avatar
Jim Blandy committed
10 11 12 13 14 15 16 17 18
any later version.

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with GNU Emacs; see the file COPYING.  If not, write to
19 20
the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.  */
Jim Blandy's avatar
Jim Blandy committed
21 22


23
#include <config.h>
Jim Blandy's avatar
Jim Blandy committed
24 25 26 27
#include <stdio.h>
/*#include <ctype.h>*/
#undef NULL
#include "lisp.h"
Jim Blandy's avatar
Jim Blandy committed
28
#include "frame.h"
Jim Blandy's avatar
Jim Blandy committed
29 30 31 32
#include "window.h"
#include "termchar.h"
#include "dispextern.h"
#include "buffer.h"
33
#include "charset.h"
Jim Blandy's avatar
Jim Blandy committed
34 35 36 37
#include "indent.h"
#include "commands.h"
#include "macros.h"
#include "disptab.h"
38
#include "termhooks.h"
39
#include "intervals.h"
Karl Heuer's avatar
Karl Heuer committed
40
#include "keyboard.h"
41 42
#include "coding.h"
#include "process.h"
Jim Blandy's avatar
Jim Blandy committed
43

44
#if defined (USE_X_TOOLKIT) || defined (HAVE_NTGUI)
45
extern void set_frame_menubar ();
46
extern int pending_menu_activation;
47 48
#endif

Jim Blandy's avatar
Jim Blandy committed
49 50 51
extern int interrupt_input;
extern int command_loop_level;

52 53
extern int minibuffer_auto_raise;

54 55
extern int nonascii_insert_offset;

56 57
extern Lisp_Object Qface;

58 59 60
extern Lisp_Object Voverriding_local_map;
extern Lisp_Object Voverriding_local_map_menu_flag;

61
Lisp_Object Qoverriding_local_map, Qoverriding_terminal_local_map;
62
Lisp_Object Qwindow_scroll_functions, Vwindow_scroll_functions;
63
Lisp_Object Qredisplay_end_trigger_functions;
64

65
/* Nonzero means print newline to stdout before next minibuffer message.  */
Jim Blandy's avatar
Jim Blandy committed
66 67 68

int noninteractive_need_newline;

69 70
/* Nonzero means print newline to message log before next message.  */

71
static int message_log_need_newline;
72

Jim Blandy's avatar
Jim Blandy committed
73 74
#define min(a, b) ((a) < (b) ? (a) : (b))
#define max(a, b) ((a) > (b) ? (a) : (b))
Karl Heuer's avatar
Karl Heuer committed
75 76
#define minmax(floor, val, ceil) \
	((val) < (floor) ? (floor) : (val) > (ceil) ? (ceil) : (val))
Jim Blandy's avatar
Jim Blandy committed
77 78

/* The buffer position of the first character appearing
Jim Blandy's avatar
Jim Blandy committed
79 80
 entirely or partially on the current frame line.
 Or zero, which disables the optimization for the current frame line. */
Jim Blandy's avatar
Jim Blandy committed
81 82 83 84 85 86
static int this_line_bufpos;

/* Number of characters past the end of this line,
   including the terminating newline */
static int this_line_endpos;

Jim Blandy's avatar
Jim Blandy committed
87
/* The vertical position of this frame line. */
Jim Blandy's avatar
Jim Blandy committed
88 89
static int this_line_vpos;

Jim Blandy's avatar
Jim Blandy committed
90
/* Hpos value for start of display on this frame line.
Jim Blandy's avatar
Jim Blandy committed
91 92 93 94 95 96 97 98
   Usually zero, but negative if first character really began
   on previous line */
static int this_line_start_hpos;

/* Buffer that this_line variables are describing. */
static struct buffer *this_line_buffer;

/* Value of echo_area_glyphs when it was last acted on.
Jim Blandy's avatar
Jim Blandy committed
99
  If this is nonzero, there is a message on the frame
Jim Blandy's avatar
Jim Blandy committed
100 101 102 103
  in the minibuffer and it should be erased as soon
  as it is no longer requested to appear. */
char *previous_echo_glyphs;

Jim Blandy's avatar
Jim Blandy committed
104
/* Nonzero means truncate lines in all windows less wide than the frame */
Jim Blandy's avatar
Jim Blandy committed
105 106
int truncate_partial_width_windows;

107 108 109 110
/* Nonzero means we have more than one non-minibuffer-only frame.
   Not guaranteed to be accurate except while parsing frame-title-format.  */
int multiple_frames;

Jim Blandy's avatar
Jim Blandy committed
111 112 113 114 115 116 117 118
Lisp_Object Vglobal_mode_string;

/* Marker for where to display an arrow on top of the buffer text.  */
Lisp_Object Voverlay_arrow_position;

/* String to display for the arrow.  */
Lisp_Object Voverlay_arrow_string;

119 120 121 122 123
/* Values of those variables at last redisplay.
   However, if Voverlay_arrow_position is a marker,
   last_arrow_position is its numerical position.  */
static Lisp_Object last_arrow_position, last_arrow_string;

124 125 126 127 128 129
/* Like mode-line-format, but for the titlebar on a visible frame.  */
Lisp_Object Vframe_title_format;

/* Like mode-line-format, but for the titlebar on an iconified frame.  */
Lisp_Object Vicon_title_format;

130 131 132 133 134
/* List of functions to call when a window's size changes.  These
   functions get one arg, a frame on which one or more windows' sizes
   have changed.  */
static Lisp_Object Vwindow_size_change_functions;

135 136
Lisp_Object Qmenu_bar_update_hook;

Jim Blandy's avatar
Jim Blandy committed
137 138 139
/* Nonzero if overlay arrow has been displayed once in this window.  */
static int overlay_arrow_seen;

Karl Heuer's avatar
Karl Heuer committed
140 141 142 143 144
/* Nonzero if visible end of buffer has already been displayed once
   in this window.  (We need this variable in case there are overlay
   strings that get displayed there.)  */
static int zv_strings_seen;

145 146 147
/* Nonzero means highlight the region even in nonselected windows.  */
static int highlight_nonselected_windows;

Jim Blandy's avatar
Jim Blandy committed
148
/* If cursor motion alone moves point off frame,
Jim Blandy's avatar
Jim Blandy committed
149
   Try scrolling this many lines up or down if that will bring it back.  */
150
static int scroll_step;
Jim Blandy's avatar
Jim Blandy committed
151

152 153 154 155
/* Non-0 means scroll just far enough to bring point back on the screen,
   when appropriate.  */
static int scroll_conservatively;

156 157 158 159
/* Recenter the window whenever point gets within this many lines
   of the top or bottom of the window.  */
int scroll_margin;

160 161 162 163
/* Number of characters of overlap to show,
   when scrolling a one-line window such as a minibuffer.  */
static int minibuffer_scroll_overlap;

Jim Blandy's avatar
Jim Blandy committed
164 165 166 167
/* Nonzero if try_window_id has made blank lines at window bottom
 since the last redisplay that paused */
static int blank_end_of_window;

168 169
/* Number of windows showing the buffer of the selected window
   (or another buffer with the same base buffer).
Jim Blandy's avatar
Jim Blandy committed
170 171 172
   keyboard.c refers to this.  */
int buffer_shared;

Jim Blandy's avatar
Jim Blandy committed
173
/* display_text_line sets these to the frame position (origin 0) of point,
Jim Blandy's avatar
Jim Blandy committed
174 175 176 177 178 179
   whether the window is selected or not.
   Set one to -1 first to determine whether point was found afterwards.  */

static int cursor_vpos;
static int cursor_hpos;

180
static int debug_end_pos;
Jim Blandy's avatar
Jim Blandy committed
181 182 183 184

/* Nonzero means display mode line highlighted */
int mode_line_inverse_video;

185
static void redisplay_internal ();
186
static int message_log_check_duplicate ();
Jim Blandy's avatar
Jim Blandy committed
187 188 189 190
static void echo_area_display ();
void mark_window_display_accurate ();
static void redisplay_windows ();
static void redisplay_window ();
191
static void update_menu_bar ();
Jim Blandy's avatar
Jim Blandy committed
192 193 194 195 196 197 198
static void try_window ();
static int try_window_id ();
static struct position *display_text_line ();
static void display_mode_line ();
static int display_mode_element ();
static char *decode_mode_spec ();
static int display_string ();
199
static void display_menu_bar ();
200
static int display_count_lines ();
Jim Blandy's avatar
Jim Blandy committed
201 202

/* Prompt to display in front of the minibuffer contents */
203
Lisp_Object minibuf_prompt;
Jim Blandy's avatar
Jim Blandy committed
204 205 206 207 208 209 210 211 212 213

/* Width in columns of current minibuffer prompt.  */
int minibuf_prompt_width;

/* Message to display instead of minibuffer contents
   This is what the functions error and message make,
   and command echoing uses it as well.
   It overrides the minibuf_prompt as well as the buffer.  */
char *echo_area_glyphs;

214 215 216
/* This is the length of the message in echo_area_glyphs.  */
int echo_area_glyphs_length;

217 218 219 220 221
/* This is the window where the echo area message was displayed.
   It is always a minibuffer window, but it may not be the
   same window currently active as a minibuffer.  */
Lisp_Object echo_area_window;

222 223 224 225
/* Nonzero means multibyte characters were enabled when the echo area
   message was specified.  */
int message_enable_multibyte;

Jim Blandy's avatar
Jim Blandy committed
226 227 228 229 230 231 232 233 234 235 236 237 238 239
/* true iff we should redraw the mode lines on the next redisplay */
int update_mode_lines;

/* Smallest number of characters before the gap
   at any time since last redisplay that finished.
   Valid for current buffer when try_window_id can be called.  */
int beg_unchanged;

/* Smallest number of characters after the gap
   at any time since last redisplay that finished.
   Valid for current buffer when try_window_id can be called.  */
int end_unchanged;

/* MODIFF as of last redisplay that finished;
240 241
   if it matches MODIFF, and overlay_unchanged_modified
   matches OVERLAY_MODIFF, that means beg_unchanged and end_unchanged
Jim Blandy's avatar
Jim Blandy committed
242 243 244
   contain no useful information */
int unchanged_modified;

245 246 247
/* OVERLAY_MODIFF as of last redisplay that finished.  */
int overlay_unchanged_modified;

Jim Blandy's avatar
Jim Blandy committed
248 249 250 251
/* Nonzero if window sizes or contents have changed
   since last redisplay that finished */
int windows_or_buffers_changed;

252 253 254 255 256
/* Nonzero after display_mode_line if %l was used
   and it displayed a line number.  */
int line_number_displayed;

/* Maximum buffer size for which to display line numbers.  */
257
static int line_number_display_limit;
Karl Heuer's avatar
Karl Heuer committed
258 259 260 261

/* Number of lines to keep in the message log buffer.
   t means infinite.  nil means don't log at all.  */
Lisp_Object Vmessage_log_max;
262 263

#define COERCE_MARKER(X)	\
264
  (MARKERP ((X)) ? Fmarker_position (X) : (X))
Jim Blandy's avatar
Jim Blandy committed
265

266 267
/* Output a newline in the *Messages* buffer if "needs" one.  */

268 269 270 271 272 273 274 275
void
message_log_maybe_newline ()
{
  if (message_log_need_newline)
    message_dolog ("", 0, 1);
}


276 277 278
/* Add a string to the message log, optionally terminated with a newline.
   This function calls low-level routines in order to bypass text property
   hooks, etc. which might not be safe to run.  */
279 280

void
281
message_dolog (m, len, nlflag)
282
     char *m;
283
     int len, nlflag;
Karl Heuer's avatar
Karl Heuer committed
284
{
285
  if (!NILP (Vmessage_log_max))
Karl Heuer's avatar
Karl Heuer committed
286 287 288
    {
      struct buffer *oldbuf;
      int oldpoint, oldbegv, oldzv;
289
      int old_windows_or_buffers_changed = windows_or_buffers_changed;
290 291
      int point_at_end = 0;
      int zv_at_end = 0;
Karl Heuer's avatar
Karl Heuer committed
292 293

      oldbuf = current_buffer;
294
      Fset_buffer (Fget_buffer_create (build_string ("*Messages*")));
295
      current_buffer->undo_list = Qt;
Karl Heuer's avatar
Karl Heuer committed
296 297 298
      oldpoint = PT;
      oldbegv = BEGV;
      oldzv = ZV;
299 300
      BEGV = BEG;
      ZV = Z;
Karl Heuer's avatar
Karl Heuer committed
301
      if (oldpoint == Z)
302
	point_at_end = 1;
Karl Heuer's avatar
Karl Heuer committed
303
      if (oldzv == Z)
304
	zv_at_end = 1;
Karl Heuer's avatar
Karl Heuer committed
305
      TEMP_SET_PT (Z);
306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341

      /* Insert the string--maybe converting multibyte to single byte
	 or vice versa, so that all the text fits the buffer.  */
      if (! NILP (oldbuf->enable_multibyte_characters)
	  && NILP (current_buffer->enable_multibyte_characters))
	{
	  int c, i = 0, nbytes;
	  /* Convert a multibyte string to single-byte
	     for the *Message* buffer.  */
	  while (i < len)
	    {
	      c = STRING_CHAR (m + i, len - i);
	      i += XFASTINT (Fchar_bytes (make_number (c)));
	      /* Truncate the character to its last byte--we can only hope
		 the user is happy with the character he gets,
		 since if it isn't right, there is no way to do it right.  */
	      c &= 0xff;
	      insert_char (c);
	    }
	}
      else if (NILP (oldbuf->enable_multibyte_characters)
	       && ! NILP (current_buffer->enable_multibyte_characters))
	{
	  int c, i = 0;
	  /* Convert a single-byte string to multibyte
	     for the *Message* buffer.  */
	  while (i < len)
	    {
	      c = m[i++];
	      /* Convert non-ascii chars as if for self-insert.  */
	      if (c >= 0200 && c <= 0377)
		c += nonascii_insert_offset;
	      insert_char (c);
	    }
	}
      else if (len)
342
	insert_1 (m, len, 1, 0);
343

344
      if (nlflag)
Karl Heuer's avatar
Karl Heuer committed
345
	{
346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390
	  int this_bol, prev_bol, dup;
	  insert_1 ("\n", 1, 1, 0);

	  this_bol = scan_buffer ('\n', Z, 0, -2, 0, 0);
	  if (this_bol > BEG)
	    {
	      prev_bol = scan_buffer ('\n', this_bol, 0, -2, 0, 0);
	      dup = message_log_check_duplicate (prev_bol, this_bol);
	      if (dup)
		{
		  if (oldpoint > prev_bol)
		    oldpoint -= min (this_bol, oldpoint) - prev_bol;
		  if (oldbegv > prev_bol)
		    oldbegv -= min (this_bol, oldbegv) - prev_bol;
		  if (oldzv > prev_bol)
		    oldzv -= min (this_bol, oldzv) - prev_bol;
		  del_range_1 (prev_bol, this_bol, 0);
		  if (dup > 1)
		    {
		      char dupstr[40];
		      int duplen;

		      /* If you change this format, don't forget to also
			 change message_log_check_duplicate.  */
		      sprintf (dupstr, " [%d times]", dup);
		      duplen = strlen (dupstr);
		      TEMP_SET_PT (Z-1);
		      if (oldpoint == Z)
			oldpoint += duplen;
		      if (oldzv == Z)
			oldzv += duplen;
		      insert_1 (dupstr, duplen, 1, 0);
		    }
		}
	    }

	  if (NATNUMP (Vmessage_log_max))
	    {
	      int pos = scan_buffer ('\n', Z, 0,
				     -XFASTINT (Vmessage_log_max) - 1, 0, 0);
	      oldpoint -= min (pos, oldpoint) - BEG;
	      oldbegv -= min (pos, oldbegv) - BEG;
	      oldzv -= min (pos, oldzv) - BEG;
	      del_range_1 (BEG, pos, 0);
	    }
Karl Heuer's avatar
Karl Heuer committed
391 392
	}
      BEGV = oldbegv;
393 394 395 396 397 398 399 400
      if (zv_at_end)
	ZV = Z;
      else
	ZV = oldzv;
      if (point_at_end)
	TEMP_SET_PT (Z);
      else
	TEMP_SET_PT (oldpoint);
Karl Heuer's avatar
Karl Heuer committed
401
      set_buffer_internal (oldbuf);
402
      windows_or_buffers_changed = old_windows_or_buffers_changed;
403
      message_log_need_newline = !nlflag;
Karl Heuer's avatar
Karl Heuer committed
404
    }
405 406
}

407 408 409 410 411
/* We are at the end of the buffer after just having inserted a newline.
   (Note: We depend on the fact we won't be crossing the gap.)
   Check to see if the most recent message looks a lot like the previous one.
   Return 0 if different, 1 if the new one should just replace it, or a
   value N > 1 if we should also append " [N times]".  */
412

413 414 415 416 417 418 419
static int
message_log_check_duplicate (prev_bol, this_bol)
     int prev_bol, this_bol;
{
  int i;
  int len = Z - 1 - this_bol;
  int seen_dots = 0;
420 421
  unsigned char *p1 = BUF_CHAR_ADDRESS (current_buffer, prev_bol);
  unsigned char *p2 = BUF_CHAR_ADDRESS (current_buffer, this_bol);
422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443

  for (i = 0; i < len; i++)
    {
      if (i >= 3 && p1[i-3] == '.' && p1[i-2] == '.' && p1[i-1] == '.'
	  && p1[i] != '\n')
	seen_dots = 1;
      if (p1[i] != p2[i])
	return seen_dots;
    }
  p1 += len;
  if (*p1 == '\n')
    return 2;
  if (*p1++ == ' ' && *p1++ == '[')
    {
      int n = 0;
      while (*p1 >= '0' && *p1 <= '9')
	n = n * 10 + *p1++ - '0';
      if (strncmp (p1, " times]\n", 8) == 0)
	return n+1;
    }
  return 0;
}
444

445
/* Display an echo area message M with a specified length of LEN chars.
446
   The string may include null characters.  If M is 0, clear out any
447
   existing message, and let the minibuffer text show through.
448 449 450 451 452 453

   The buffer M must continue to exist until after the echo area
   gets cleared or some other message gets displayed there.

   Do not pass text that is stored in a Lisp string.
   Do not pass text in a buffer that was alloca'd.  */
454 455 456 457 458 459 460

void
message2 (m, len)
     char *m;
     int len;
{
  /* First flush out any partial line written with print.  */
461
  message_log_maybe_newline ();
462 463
  if (m)
    message_dolog (m, len, 1);
464 465
  message2_nolog (m, len,
		  ! NILP (current_buffer->enable_multibyte_characters));
Karl Heuer's avatar
Karl Heuer committed
466 467 468
}


469
/* The non-logging counterpart of message2.  */
Karl Heuer's avatar
Karl Heuer committed
470 471

void
472
message2_nolog (m, len, multibyte)
Karl Heuer's avatar
Karl Heuer committed
473 474
     char *m;
     int len;
475
{
476
  message_enable_multibyte = multibyte;
477

478 479 480 481 482
  if (noninteractive)
    {
      if (noninteractive_need_newline)
	putc ('\n', stderr);
      noninteractive_need_newline = 0;
483 484
      if (m)
	fwrite (m, len, 1, stderr);
485 486 487 488 489 490 491 492 493
      if (cursor_in_echo_area == 0)
	fprintf (stderr, "\n");
      fflush (stderr);
    }
  /* A null message buffer means that the frame hasn't really been
     initialized yet.  Error messages get reported properly by
     cmd_error, so this must be just an informative message; toss it.  */
  else if (INTERACTIVE && FRAME_MESSAGE_BUF (selected_frame))
    {
494 495
      Lisp_Object mini_window;
      FRAME_PTR f;
496

497 498 499 500 501 502
      /* Get the frame containing the minibuffer
	 that the selected frame is using.  */
      mini_window = FRAME_MINIBUF_WINDOW (selected_frame);
      f = XFRAME (WINDOW_FRAME (XWINDOW (mini_window)));

      FRAME_SAMPLE_VISIBILITY (f);
503
      if (FRAME_VISIBLE_P (selected_frame)
504 505
	  && ! FRAME_VISIBLE_P (f))
	Fmake_frame_visible (WINDOW_FRAME (XWINDOW (mini_window)));
506 507 508 509 510

      if (m)
	{
	  echo_area_glyphs = m;
	  echo_area_glyphs_length = len;
511 512 513

	  if (minibuffer_auto_raise)
	    Fraise_frame  (WINDOW_FRAME (XWINDOW (mini_window)));
514
	}
515 516 517 518 519
      else
	echo_area_glyphs = previous_echo_glyphs = 0;

      do_pending_window_change ();
      echo_area_display ();
520
      update_frame (f, 1, 1);
521
      do_pending_window_change ();
522
      if (frame_up_to_date_hook != 0 && ! gc_in_progress)
523
	(*frame_up_to_date_hook) (f);
524 525
    }
}
526 527 528 529 530 531 532 533 534

/* Display a null-terminated echo area message M.  If M is 0, clear out any
   existing message, and let the minibuffer text show through.

   The buffer M must continue to exist until after the echo area
   gets cleared or some other message gets displayed there.

   Do not pass text that is stored in a Lisp string.
   Do not pass text in a buffer that was alloca'd.  */
535

536 537 538 539 540 541 542
void
message1 (m)
     char *m;
{
  message2 (m, (m ? strlen (m) : 0));
}

Karl Heuer's avatar
Karl Heuer committed
543 544 545 546
void
message1_nolog (m)
     char *m;
{
547 548
  message2_nolog (m, (m ? strlen (m) : 0),
		  ! NILP (current_buffer->enable_multibyte_characters));
Karl Heuer's avatar
Karl Heuer committed
549 550
}

551 552 553 554 555 556 557 558 559 560 561 562 563 564
/* Truncate what will be displayed in the echo area
   the next time we display it--but don't redisplay it now.  */

void
truncate_echo_area (len)
     int len;
{
  /* A null message buffer means that the frame hasn't really been
     initialized yet.  Error messages get reported properly by
     cmd_error, so this must be just an informative message; toss it.  */
  if (!noninteractive && INTERACTIVE && FRAME_MESSAGE_BUF (selected_frame))
    echo_area_glyphs_length = len;
}

Jim Blandy's avatar
Jim Blandy committed
565
/* Nonzero if FRAME_MESSAGE_BUF (selected_frame) is being used by print;
Jim Blandy's avatar
Jim Blandy committed
566 567 568
   zero if being used by message.  */
int message_buf_print;

569
/* Dump an informative message to the minibuf.  If M is 0, clear out
570
   any existing message, and let the minibuffer text show through.  */
571

Jim Blandy's avatar
Jim Blandy committed
572 573 574 575
/* VARARGS 1 */
void
message (m, a1, a2, a3)
     char *m;
576
     EMACS_INT a1, a2, a3;
Jim Blandy's avatar
Jim Blandy committed
577 578 579
{
  if (noninteractive)
    {
580 581 582 583 584 585
      if (m)
	{
	  if (noninteractive_need_newline)
	    putc ('\n', stderr);
	  noninteractive_need_newline = 0;
	  fprintf (stderr, m, a1, a2, a3);
586 587
	  if (cursor_in_echo_area == 0)
	    fprintf (stderr, "\n");
588 589
	  fflush (stderr);
	}
Jim Blandy's avatar
Jim Blandy committed
590
    }
591
  else if (INTERACTIVE)
Jim Blandy's avatar
Jim Blandy committed
592
    {
593 594 595
      /* The frame whose minibuffer we're going to display the message on.
	 It may be larger than the selected frame, so we need
	 to use its buffer, not the selected frame's buffer.  */
596 597 598 599 600 601 602
      Lisp_Object mini_window;
      FRAME_PTR f;

      /* Get the frame containing the minibuffer
	 that the selected frame is using.  */
      mini_window = FRAME_MINIBUF_WINDOW (selected_frame);
      f = XFRAME (WINDOW_FRAME (XWINDOW (mini_window)));
603 604 605 606

      /* A null message buffer means that the frame hasn't really been
	 initialized yet.  Error messages get reported properly by
	 cmd_error, so this must be just an informative message; toss it.  */
607
      if (FRAME_MESSAGE_BUF (f))
608
	{
609 610
	  if (m)
	    {
611
	      int len;
Jim Blandy's avatar
Jim Blandy committed
612
#ifdef NO_ARG_ARRAY
613 614 615 616
	      char *a[3];
	      a[0] = (char *) a1;
	      a[1] = (char *) a2;
	      a[2] = (char *) a3;
Jim Blandy's avatar
Jim Blandy committed
617

618
	      len = doprnt (FRAME_MESSAGE_BUF (f),
619
			    FRAME_MESSAGE_BUF_SIZE (f), m, (char *)0, 3, a);
Jim Blandy's avatar
Jim Blandy committed
620
#else
621
	      len = doprnt (FRAME_MESSAGE_BUF (f),
622
			    FRAME_MESSAGE_BUF_SIZE (f), m, (char *)0, 3, &a1);
623 624
#endif /* NO_ARG_ARRAY */

625
	      message2 (FRAME_MESSAGE_BUF (f), len);
626 627 628 629 630 631 632
	    }
	  else
	    message1 (0);

	  /* Print should start at the beginning of the message
	     buffer next time.  */
	  message_buf_print = 0;
633
	}
Jim Blandy's avatar
Jim Blandy committed
634 635 636
    }
}

637
/* The non-logging version of message.  */
Karl Heuer's avatar
Karl Heuer committed
638 639 640 641 642 643 644 645 646 647 648 649
void
message_nolog (m, a1, a2, a3)
     char *m;
     EMACS_INT a1, a2, a3;
{
  Lisp_Object old_log_max;
  old_log_max = Vmessage_log_max;
  Vmessage_log_max = Qnil;
  message (m, a1, a2, a3);
  Vmessage_log_max = old_log_max;
}

650 651 652 653 654
void
update_echo_area ()
{
  message2 (echo_area_glyphs, echo_area_glyphs_length);
}
655

Jim Blandy's avatar
Jim Blandy committed
656 657 658 659
static void
echo_area_display ()
{
  register int vpos;
Jim Blandy's avatar
Jim Blandy committed
660
  FRAME_PTR f;
661
  Lisp_Object mini_window;
Jim Blandy's avatar
Jim Blandy committed
662

663 664 665 666 667
  /* Choose the minibuffer window for this display.
     It is the minibuffer window used by the selected frame.  */
  mini_window = FRAME_MINIBUF_WINDOW (selected_frame);
  /* This is the frame that window is in.  */
  f = XFRAME (WINDOW_FRAME (XWINDOW (mini_window)));
Jim Blandy's avatar
Jim Blandy committed
668

Jim Blandy's avatar
Jim Blandy committed
669
  if (! FRAME_VISIBLE_P (f))
Jim Blandy's avatar
Jim Blandy committed
670 671
    return;

Jim Blandy's avatar
Jim Blandy committed
672
  if (frame_garbaged)
Jim Blandy's avatar
Jim Blandy committed
673
    {
674
      redraw_garbaged_frames ();
Jim Blandy's avatar
Jim Blandy committed
675
      frame_garbaged = 0;
Jim Blandy's avatar
Jim Blandy committed
676 677 678 679
    }

  if (echo_area_glyphs || minibuf_level == 0)
    {
680 681
      int i;

682 683 684
      echo_area_window = mini_window;

      vpos = XFASTINT (XWINDOW (mini_window)->top);
Jim Blandy's avatar
Jim Blandy committed
685
      get_display_line (f, vpos, 0);
686 687 688 689 690 691

      /* Make sure the columns that overlap a left-hand scroll bar
	 are always clear.  */
      for (i = 0; i < FRAME_LEFT_SCROLL_BAR_WIDTH (f); i++)
	f->desired_glyphs->glyphs[vpos][i] = SPACEGLYPH;

692
      display_string (XWINDOW (mini_window), vpos,
Jim Blandy's avatar
Jim Blandy committed
693
		      echo_area_glyphs ? echo_area_glyphs : "",
694
		      echo_area_glyphs ? echo_area_glyphs_length : -1,
695
		      FRAME_LEFT_SCROLL_BAR_WIDTH (f),
696
		      0, 0, 0,
697 698
		      FRAME_WIDTH (f) + FRAME_LEFT_SCROLL_BAR_WIDTH (f),
		      message_enable_multibyte);
Jim Blandy's avatar
Jim Blandy committed
699

700
#if 0 /* This just gets in the way.  update_frame does the job.  */
Jim Blandy's avatar
Jim Blandy committed
701
      /* If desired cursor location is on this line, put it at end of text */
702 703
      if (cursor_in_echo_area)
	FRAME_CURSOR_Y (f) = vpos;
Jim Blandy's avatar
Jim Blandy committed
704 705
      if (FRAME_CURSOR_Y (f) == vpos)
	FRAME_CURSOR_X (f) = FRAME_DESIRED_GLYPHS (f)->used[vpos];
706
#endif
Jim Blandy's avatar
Jim Blandy committed
707 708 709 710 711

      /* Fill the rest of the minibuffer window with blank lines.  */
      {
	int i;

712
	for (i = vpos + 1;
713
	     i < vpos + XFASTINT (XWINDOW (mini_window)->height); i++)
Jim Blandy's avatar
Jim Blandy committed
714
	  {
Jim Blandy's avatar
Jim Blandy committed
715
	    get_display_line (f, i, 0);
716 717 718
	    /* We don't use FRAME_SCROLL_BAR_WIDTH (f) as the starting
	       hpos, because it is good to clear whatever is behind the
	       scroll bar.  This does not affect the scroll bar itself.  */
719
	    display_string (XWINDOW (mini_window), i,
720
			    "", 0, 
721
                            0, 0, 0,
722 723
                            0, FRAME_WIDTH (f) + FRAME_SCROLL_BAR_WIDTH (f),
			    0);
Jim Blandy's avatar
Jim Blandy committed
724 725
	  }
      }
Jim Blandy's avatar
Jim Blandy committed
726
    }
727
  else if (!EQ (mini_window, selected_window))
Jim Blandy's avatar
Jim Blandy committed
728 729
    windows_or_buffers_changed++;

730
  if (EQ (mini_window, selected_window))
Jim Blandy's avatar
Jim Blandy committed
731 732 733 734
    this_line_bufpos = 0;

  previous_echo_glyphs = echo_area_glyphs;
}
735 736

/* Update frame titles.  */
737

738
#ifdef HAVE_WINDOW_SYSTEM
739 740
static char frame_title_buf[512];
static char *frame_title_ptr;
741

742 743 744 745 746 747 748 749 750 751 752 753 754 755 756
static int
store_frame_title (str, mincol, maxcol)
     char *str;
     int mincol, maxcol;
{
  char *limit;
  if (maxcol < 0 || maxcol >= sizeof(frame_title_buf))
    maxcol = sizeof (frame_title_buf);
  limit = &frame_title_buf[maxcol];
  while (*str != '\0' && frame_title_ptr < limit)
    *frame_title_ptr++ = *str++;
  while (frame_title_ptr < &frame_title_buf[mincol])
    *frame_title_ptr++ = ' ';
  return frame_title_ptr - frame_title_buf;
}
757 758 759 760 761

static void
x_consider_frame_title (frame)
     Lisp_Object frame;
{
762 763 764
  Lisp_Object fmt;
  struct buffer *obuf;
  int len;
765 766
  FRAME_PTR f = XFRAME (frame);

767
  if (!(FRAME_WINDOW_P (f) || FRAME_MINIBUF_ONLY_P (f) || f->explicit_name))
768
    return;
769 770 771 772 773 774 775 776 777

  /* Do we have more than one visible frame on this X display?  */
  {
    Lisp_Object tail;

    for (tail = Vframe_list; CONSP (tail); tail = XCONS (tail)->cdr)
      {
	FRAME_PTR tf = XFRAME (XCONS (tail)->car);

778 779
	if (tf != f && FRAME_KBOARD (tf) == FRAME_KBOARD (f)
	    && !FRAME_MINIBUF_ONLY_P (tf)
780 781 782 783 784 785 786
	    && (FRAME_VISIBLE_P (tf) || FRAME_ICONIFIED_P (tf)))
	  break;
      }

    multiple_frames = CONSP (tail);
  }

787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802
  obuf = current_buffer;
  Fset_buffer (XWINDOW (f->selected_window)->buffer);
  fmt = (FRAME_ICONIFIED_P (f) ? Vicon_title_format : Vframe_title_format);
  frame_title_ptr = frame_title_buf;
  len = display_mode_element (XWINDOW (f->selected_window), 0, 0, 0,
			      0, sizeof (frame_title_buf), fmt);
  frame_title_ptr = 0;
  set_buffer_internal (obuf);
  /* Set the name only if it's changed.  This avoids consing
     in the common case where it hasn't.  (If it turns out that we've
     already wasted too much time by walking through the list with
     display_mode_element, then we might need to optimize at a higher
     level than this.)  */
  if (! STRINGP (f->name) || XSTRING (f->name)->size != len
      || bcmp (frame_title_buf, XSTRING (f->name)->data, len) != 0)
    x_implicitly_set_name (f, make_string (frame_title_buf, len), Qnil);
803
}
804 805
#else
#define frame_title_ptr ((char *)0)
806
#define store_frame_title(str, mincol, maxcol) 0
807
#endif
Jim Blandy's avatar
Jim Blandy committed
808

809
/* Prepare for redisplay by updating menu-bar item lists when appropriate.
Richard M. Stallman's avatar
Richard M. Stallman committed
810
   This can call eval.  */
811 812 813 814 815 816

void
prepare_menu_bars ()
{
  register struct window *w = XWINDOW (selected_window);
  int all_windows;
817
  struct gcpro gcpro1, gcpro2;
818

819
  all_windows = (update_mode_lines || buffer_shared > 1
820
		 || windows_or_buffers_changed);
821

822 823 824 825 826 827 828 829 830 831
  /* Update all frame titles based on their buffer names, etc.
     We do this before the menu bars so that the buffer-menu
     will show the up-to-date frame titles.

     This used to be done after the menu bars, for a reason that
     was stated as follows but which I do not understand:
     "We do this after the menu bars so that the frame will first
     create its menu bar using the name `emacs' if no other name
     has yet been specified."
     I think that is no longer a concern.  */
832
#ifdef HAVE_WINDOW_SYSTEM
833
  if (windows_or_buffers_changed || update_mode_lines)
834 835 836 837 838 839 840 841 842 843
    {
      Lisp_Object tail, frame;

      FOR_EACH_FRAME (tail, frame)
	if (FRAME_VISIBLE_P (XFRAME (frame))
	    || FRAME_ICONIFIED_P (XFRAME (frame)))
	  x_consider_frame_title (frame);
    }
#endif

844 845 846 847 848 849
  /* Update the menu bar item lists, if appropriate.
     This has to be done before any actual redisplay
     or generation of display lines.  */
  if (all_windows)
    {
      Lisp_Object tail, frame;
850 851
      int count = specpdl_ptr - specpdl;

852
      record_unwind_protect (Fstore_match_data, Fmatch_data (Qnil, Qnil));
853 854

      FOR_EACH_FRAME (tail, frame)
855 856 857 858 859 860
	{
	  /* If a window on this frame changed size,
	     report that to the user and clear the size-change flag.  */
	  if (FRAME_WINDOW_SIZES_CHANGED (XFRAME (frame)))
	    {
	      Lisp_Object functions;
861 862
	      /* Clear flag first in case we get error below.  */
	      FRAME_WINDOW_SIZES_CHANGED (XFRAME (frame)) = 0;
863 864 865 866 867 868 869 870 871 872
	      functions = Vwindow_size_change_functions;
	      GCPRO2 (tail, functions);
	      while (CONSP (functions))
		{
		  call1 (XCONS (functions)->car, frame);
		  functions = XCONS (functions)->cdr;
		}
	      UNGCPRO;
	    }
	  GCPRO1 (tail);
873
	  update_menu_bar (XFRAME (frame), 0);
874 875
	  UNGCPRO;
	}
876 877

      unbind_to (count, Qnil);
878
    }
879
  else
880
    update_menu_bar (selected_frame, 1);
881 882 883 884 885 886

  /* Motif needs this.  See comment in xmenu.c.
     Turn it off when pending_menu_activation is not defined.  */
#ifdef USE_X_TOOLKIT
  pending_menu_activation = 0;
#endif
887 888
}

Jim Blandy's avatar
Jim Blandy committed
889
/* Do a frame update, taking possible shortcuts into account.
Jim Blandy's avatar
Jim Blandy committed
890 891 892 893 894 895
   This is the main external entry point for redisplay.

   If the last redisplay displayed an echo area message and that
   message is no longer requested, we clear the echo area
   or bring back the minibuffer if that is in use.

896 897 898 899 900 901
   Do not call eval from within this function.
   Calls to eval after the call to echo_area_display would confuse
   the display_line mechanism and would cause a crash.
   Calls to eval before that point will work most of the time,
   but can still lose, because  this function
   can be called from signal handlers; with alarms set up;
Jim Blandy's avatar
Jim Blandy committed
902
   or with synchronous processes running.
903

Jim Blandy's avatar
Jim Blandy committed
904 905 906
   See Fcall_process; if you called it from here, it could be
   entered recursively.  */

907 908
static int do_verify_charstarts;

909 910 911 912
/* Counter is used to clear the face cache
   no more than once ever 1000 redisplays.  */
static int clear_face_cache_count;

913 914 915
/* Record the previous terminal frame we displayed.  */
static FRAME_PTR previous_terminal_frame;

Jim Blandy's avatar
Jim Blandy committed
916 917
void
redisplay ()
918 919 920 921 922 923
{
  redisplay_internal (0);
}

/* If PRESERVE_ECHO_AREA is nonzero, it means this redisplay
   is not in response to any user action; therefore, we should
Richard M. Stallman's avatar
Richard M. Stallman committed
924 925
   preserve the echo area.  (Actually, our caller does that job.)
   Perhaps in the future avoid recentering windows
926 927 928 929 930
   if it is not necessary; currently that causes some problems.  */

static void
redisplay_internal (preserve_echo_area)
     int preserve_echo_area;
Jim Blandy's avatar
Jim Blandy committed
931 932 933 934 935 936 937
{
  register struct window *w = XWINDOW (selected_window);
  register int pause;
  int must_finish = 0;
  int all_windows;
  register int tlbufpos, tlendpos;
  struct position pos;
938
  int number_of_visible_frames;
Jim Blandy's avatar
Jim Blandy committed
939 940 941 942

  if (noninteractive)
    return;

943 944 945 946 947
#ifdef USE_X_TOOLKIT
  if (popup_activated ())
    return;
#endif

948 949
 retry:

950
  if (! FRAME_WINDOW_P (selected_frame)
951 952 953 954 955 956 957 958 959 960
      && previous_terminal_frame != selected_frame)
    {
      /* Since frames on an ASCII terminal share the same display area,
	 displaying a different frame means redisplay the whole thing.  */
      windows_or_buffers_changed++;
      SET_FRAME_GARBAGED (selected_frame);
      XSETFRAME (Vterminal_frame, selected_frame);
    }
  previous_terminal_frame = selected_frame;

961 962 963 964 965
  /* Set the visible flags for all frames.
     Do this before checking for resized or garbaged frames; they want
     to know if their frames are visible.
     See the comment in frame.h for FRAME_SAMPLE_VISIBILITY.  */
  {
966
    Lisp_Object tail, frame;
967

968 969
    number_of_visible_frames = 0;

970
    FOR_EACH_FRAME (tail, frame)
971 972 973
      {
	FRAME_SAMPLE_VISIBILITY (XFRAME (frame));

974 975
	if (FRAME_VISIBLE_P (XFRAME (frame)))
	  number_of_visible_frames++;
976

977 978 979 980
	/* Clear out all the display lines in which we will generate the
	   glyphs to display.  */
	init_desired_glyphs (XFRAME (frame));
      }
981 982
  }

Jim Blandy's avatar
Jim Blandy committed
983
  /* Notice any pending interrupt request to change frame size.  */
Jim Blandy's avatar
Jim Blandy committed
984 985
  do_pending_window_change ();

Jim Blandy's avatar
Jim Blandy committed
986
  if (frame_garbaged)
Jim Blandy's avatar
Jim Blandy committed
987
    {
988
      redraw_garbaged_frames ();
Jim Blandy's avatar
Jim Blandy committed
989
      frame_garbaged = 0;
Jim Blandy's avatar
Jim Blandy committed
990 991
    }

992 993
  prepare_menu_bars ();

994
  if (windows_or_buffers_changed)
Jim Blandy's avatar
Jim Blandy committed
995 996
    update_mode_lines++;

997 998
  /* Detect case that we need to write or remove a star in the mode line.  */
  if ((SAVE_MODIFF < MODIFF) != !NILP (w->last_had_star))
Jim Blandy's avatar
Jim Blandy committed
999 1000 1001 1002 1003 1004
    {
      w->update_mode_line = Qt;
      if (buffer_shared > 1)
	update_mode_lines++;
    }

1005 1006 1007 1008 1009
  /* If %c is in use, update it if needed.  */
  if (!NILP (w->column_number_displayed)
      /* This alternative quickly identifies a common case
	 where no change is needed.  */
      && !(PT == XFASTINT (w->last_point)
1010 1011
	   && XFASTINT (w->last_modified) >= MODIFF
	   && XFASTINT (w->last_overlay_modified) >= OVERLAY_MODIFF)
1012 1013 1014
      && XFASTINT (w->column_number_displayed) != current_column ())
    w->update_mode_line = Qt; 

Jim Blandy's avatar
Jim Blandy committed
1015
  FRAME_SCROLL_BOTTOM_VPOS (XFRAME (w->frame)) = -1;
Jim Blandy's avatar
Jim Blandy committed
1016 1017 1018 1019 1020

  all_windows = update_mode_lines || buffer_shared > 1;

  /* If specs for an arrow have changed, do thorough redisplay
     to ensure we remove any arrow that should no longer exist.  */
1021
  if (! EQ (COERCE_MARKER (Voverlay_arrow_position), last_arrow_position)
1022
      || ! EQ (Voverlay_arrow_string, last_arrow_string))
1023
    all_windows = 1;
Jim Blandy's avatar
Jim Blandy committed
1024

1025 1026 1027 1028 1029 1030 1031 1032 1033 1034
  /* Normally the message* functions will have already displayed and
     updated the echo area, but the frame may have been trashed, or
     the update may have been preempted, so display the echo area
     again here.  */
  if (echo_area_glyphs || previous_echo_glyphs)
    {
      echo_area_display ();
      must_finish = 1;
    }

1035 1036 1037 1038
  /* If showing region, and mark has changed, must redisplay whole window.  */
  if (((!NILP (Vtransient_mark_mode)
	&& !NILP (XBUFFER (w->buffer)->mark_active))
       != !NILP (w->region_showing))
1039 1040 1041
      || (!NILP (w->region_showing)
	  && !EQ (w->region_showing,
		  Fmarker_position (XBUFFER (w->buffer)->mark))))
1042 1043
    this_line_bufpos = -1;

Jim Blandy's avatar
Jim Blandy committed
1044 1045
  tlbufpos = this_line_bufpos;
  tlendpos = this_line_endpos;
Jim Blandy's avatar
Jim Blandy committed
1046
  if (!all_windows && tlbufpos > 0 && NILP (w->update_mode_line)
1047
      && !current_buffer->clip_changed
Jim Blandy's avatar
Jim Blandy committed
1048
      && FRAME_VISIBLE_P (XFRAME (w->frame))
1049
      && !FRAME_OBSCURED_P (XFRAME (w->frame))
Jim Blandy's avatar
Jim Blandy committed
1050 1051 1052
      /* Make sure recorded data applies to current buffer, etc */
      && this_line_buffer == current_buffer
      && current_buffer == XBUFFER (w->buffer)
Jim Blandy's avatar
Jim Blandy committed
1053
      && NILP (w->force_start)
Jim Blandy's avatar
Jim Blandy committed
1054
      /* Point must be on the line that we have info recorded about */
Karl Heuer's avatar
Karl Heuer committed
1055 1056
      && PT >= tlbufpos
      && PT <= Z - tlendpos
Jim Blandy's avatar
Jim Blandy committed
1057 1058
      /* All text outside that line, including its final newline,
	 must be unchanged */
1059 1060
      && ((XFASTINT (w->last_modified) >= MODIFF
	   && (XFASTINT (w->last_overlay_modified) >= OVERLAY_MODIFF))
Jim Blandy's avatar
Jim Blandy committed
1061 1062
	  || (beg_unchanged >= tlbufpos - 1
	      && GPT >= tlbufpos
Jim Blandy's avatar
Jim Blandy committed
1063 1064
	      /* If selective display, can't optimize
		 if the changes start at the beginning of the line.  */
1065
	      && ((INTEGERP (current_buffer->selective_display)
Jim Blandy's avatar
Jim Blandy committed
1066 1067 1068 1069
		   && XINT (current_buffer->selective_display) > 0
		   ? (beg_unchanged >= tlbufpos
		      && GPT > tlbufpos)
		   : 1))
Jim Blandy's avatar
Jim Blandy committed
1070 1071 1072
	      && end_unchanged >= tlendpos
	      && Z - GPT >= tlendpos)))
    {
1073
      if (tlbufpos > BEGV && FETCH_BYTE (tlbufpos - 1) != '\n'
Jim Blandy's avatar
Jim Blandy committed
1074
	  && (tlbufpos == ZV
1075
	      || FETCH_BYTE (tlbufpos) == '\n'))
Jim Blandy's avatar
Jim Blandy committed
1076 1077 1078
	/* Former continuation line has disappeared by becoming empty */
	goto cancel;
      else if (XFASTINT (w->last_modified) < MODIFF
1079
	       || XFASTINT (w->last_overlay_modified) < OVERLAY_MODIFF
Jim Blandy's avatar
Jim Blandy committed
1080 1081
	       || MINI_WINDOW_P (w))
	{
1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110
	  /* We have to handle the case of continuation around a
	     wide-column character (See the comment in indent.c around
	     line 885).

	     For instance, in the following case:

	     --------  Insert  --------
	     K_A_N_\\   `a'    K_A_N_a\		`X_' are wide-column chars.
	     J_I_       ==>    J_I_		`^^' are cursors.
	     ^^                ^^
	     --------          --------

	     As we have to redraw the line above, we should goto cancel.  */

	  struct position val;
	  int prevline;

	  prevline = find_next_newline (tlbufpos, -1);
	  val = *compute_motion (prevline, 0,
				 XINT (w->hscroll) ? 1 - XINT (w->hscroll) : 0,
				 0,
				 tlbufpos,
				 1 << (BITS_PER_SHORT - 1),
				 1 << (BITS_PER_SHORT - 1),
				 window_internal_width (w) - 1,
				 XINT (w->hscroll), 0, w);
	  if (val.hpos != this_line_start_hpos)
	    goto cancel;

Jim Blandy's avatar
Jim Blandy committed
1111 1112
	  cursor_vpos = -1;
	  overlay_arrow_seen = 0;
Karl Heuer's avatar
Karl Heuer committed
1113
	  zv_strings_seen = 0;
Jim Blandy's avatar
Jim Blandy committed
1114
	  display_text_line (w, tlbufpos, this_line_vpos, this_line_start_hpos,
1115
			     pos_tab_offset (w, tlbufpos), 0);
Jim Blandy's avatar
Jim Blandy committed
1116 1117 1118 1119 1120
	  /* If line contains point, is not continued,
		 and ends at same distance from eob as before, we win */
	  if (cursor_vpos >= 0 && this_line_bufpos
	      && this_line_endpos == tlendpos)
	    {
1121 1122 1123 1124
	      /* If this is not the window's last line,
		 we must adjust the charstarts of the lines below.  */
	      if (this_line_vpos + 1
		  < XFASTINT (w->top) + window_internal_height (w))
1125
		{
1126
		  int left = WINDOW_LEFT_MARGIN (w);
1127 1128 1129