xdisp.c 162 KB
Newer Older
Jim Blandy's avatar
Jim Blandy committed
1
/* Display generation from window structure and buffer text.
2
   Copyright (C) 1985, 86, 87, 88, 93, 94, 95, 97, 1998
3
     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"
Andreas Schwab's avatar
Andreas Schwab committed
43 44 45 46 47
#include "region-cache.h"

#ifdef HAVE_WINDOW_SYSTEM
#include "xterm.h"
#endif
Jim Blandy's avatar
Jim Blandy committed
48

49
#if defined (USE_X_TOOLKIT) || defined (HAVE_NTGUI)
50
extern void set_frame_menubar ();
51
extern int pending_menu_activation;
52 53
#endif

Jim Blandy's avatar
Jim Blandy committed
54 55 56
extern int interrupt_input;
extern int command_loop_level;

57 58
extern int minibuffer_auto_raise;

59 60
extern Lisp_Object Qface;

61 62 63
extern Lisp_Object Voverriding_local_map;
extern Lisp_Object Voverriding_local_map_menu_flag;

64
Lisp_Object Qoverriding_local_map, Qoverriding_terminal_local_map;
65
Lisp_Object Qwindow_scroll_functions, Vwindow_scroll_functions;
66
Lisp_Object Qredisplay_end_trigger_functions;
67
Lisp_Object Qinhibit_point_motion_hooks;
68

69
/* Nonzero means print newline to stdout before next minibuffer message.  */
Jim Blandy's avatar
Jim Blandy committed
70 71 72

int noninteractive_need_newline;

73 74
/* Nonzero means print newline to message log before next message.  */

75
static int message_log_need_newline;
76

Jim Blandy's avatar
Jim Blandy committed
77 78
#define min(a, b) ((a) < (b) ? (a) : (b))
#define max(a, b) ((a) > (b) ? (a) : (b))
Karl Heuer's avatar
Karl Heuer committed
79 80
#define minmax(floor, val, ceil) \
	((val) < (floor) ? (floor) : (val) > (ceil) ? (ceil) : (val))
Jim Blandy's avatar
Jim Blandy committed
81 82

/* The buffer position of the first character appearing
Jim Blandy's avatar
Jim Blandy committed
83 84
 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
85 86 87 88 89 90
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
91
/* The vertical position of this frame line. */
Jim Blandy's avatar
Jim Blandy committed
92 93
static int this_line_vpos;

Jim Blandy's avatar
Jim Blandy committed
94
/* Hpos value for start of display on this frame line.
Jim Blandy's avatar
Jim Blandy committed
95 96 97 98 99 100 101 102
   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
103
  If this is nonzero, there is a message on the frame
Jim Blandy's avatar
Jim Blandy committed
104 105 106 107
  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
108
/* Nonzero means truncate lines in all windows less wide than the frame */
Jim Blandy's avatar
Jim Blandy committed
109 110
int truncate_partial_width_windows;

111 112 113 114
/* 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
115 116 117 118 119 120 121 122
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;

123 124 125 126 127
/* 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;

128 129 130 131 132 133
/* 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;

134 135 136 137 138
/* 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;

139 140
Lisp_Object Qmenu_bar_update_hook;

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

Karl Heuer's avatar
Karl Heuer committed
144 145 146 147 148
/* 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;

149 150 151
/* Nonzero means highlight the region even in nonselected windows.  */
static int highlight_nonselected_windows;

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

156 157 158 159
/* Non-0 means scroll just far enough to bring point back on the screen,
   when appropriate.  */
static int scroll_conservatively;

160 161 162 163
/* Recenter the window whenever point gets within this many lines
   of the top or bottom of the window.  */
int scroll_margin;

164 165 166 167
/* 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
168 169 170 171
/* Nonzero if try_window_id has made blank lines at window bottom
 since the last redisplay that paused */
static int blank_end_of_window;

172 173
/* 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
174 175 176
   keyboard.c refers to this.  */
int buffer_shared;

Jim Blandy's avatar
Jim Blandy committed
177
/* display_text_line sets these to the frame position (origin 0) of point,
Jim Blandy's avatar
Jim Blandy committed
178 179 180 181 182 183
   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;

184
static int debug_end_pos;
Jim Blandy's avatar
Jim Blandy committed
185 186 187 188

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

189
static void redisplay_internal ();
190
static int message_log_check_duplicate ();
Jim Blandy's avatar
Jim Blandy committed
191 192 193 194
static void echo_area_display ();
void mark_window_display_accurate ();
static void redisplay_windows ();
static void redisplay_window ();
195
static void update_menu_bar ();
Jim Blandy's avatar
Jim Blandy committed
196 197 198 199 200 201 202
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 ();
203
static void display_menu_bar ();
204
static int display_count_lines ();
Jim Blandy's avatar
Jim Blandy committed
205 206

/* Prompt to display in front of the minibuffer contents */
207
Lisp_Object minibuf_prompt;
Jim Blandy's avatar
Jim Blandy committed
208 209 210 211 212 213 214 215 216 217

/* 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;

218 219 220
/* This is the length of the message in echo_area_glyphs.  */
int echo_area_glyphs_length;

221 222 223 224 225
/* 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;

226 227 228 229
/* Nonzero means multibyte characters were enabled when the echo area
   message was specified.  */
int message_enable_multibyte;

Jim Blandy's avatar
Jim Blandy committed
230 231 232 233 234 235 236 237 238 239 240 241 242 243
/* 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;
244 245
   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
246 247 248
   contain no useful information */
int unchanged_modified;

249 250 251
/* OVERLAY_MODIFF as of last redisplay that finished.  */
int overlay_unchanged_modified;

Jim Blandy's avatar
Jim Blandy committed
252 253 254 255
/* Nonzero if window sizes or contents have changed
   since last redisplay that finished */
int windows_or_buffers_changed;

256 257 258 259 260
/* 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.  */
261
static int line_number_display_limit;
Karl Heuer's avatar
Karl Heuer committed
262 263 264 265

/* 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;
266 267

#define COERCE_MARKER(X)	\
268
  (MARKERP ((X)) ? Fmarker_position (X) : (X))
269 270

static int pos_tab_offset P_ ((struct window *, int, int));
Jim Blandy's avatar
Jim Blandy committed
271

272 273
/* Output a newline in the *Messages* buffer if "needs" one.  */

274 275 276 277
void
message_log_maybe_newline ()
{
  if (message_log_need_newline)
278
    message_dolog ("", 0, 1, 0);
279 280 281
}


282 283
/* Add a string to the message log, optionally terminated with a newline.
   This function calls low-level routines in order to bypass text property
284 285
   hooks, etc. which might not be safe to run.
   MULTIBYTE, if nonzero, means interpret the contents of M as multibyte.  */
286 287

void
288
message_dolog (m, len, nlflag, multibyte)
289
     char *m;
290
     int len, nlflag, multibyte;
Karl Heuer's avatar
Karl Heuer committed
291
{
292
  if (!NILP (Vmessage_log_max))
Karl Heuer's avatar
Karl Heuer committed
293 294
    {
      struct buffer *oldbuf;
295
      Lisp_Object oldpoint, oldbegv, oldzv;
296
      int old_windows_or_buffers_changed = windows_or_buffers_changed;
297 298
      int point_at_end = 0;
      int zv_at_end = 0;
299
      Lisp_Object old_deactivate_mark;
Karl Heuer's avatar
Karl Heuer committed
300

301
      old_deactivate_mark = Vdeactivate_mark;
Karl Heuer's avatar
Karl Heuer committed
302
      oldbuf = current_buffer;
303
      Fset_buffer (Fget_buffer_create (build_string ("*Messages*")));
304
      current_buffer->undo_list = Qt;
305 306 307 308 309

      oldpoint = Fpoint_marker ();
      oldbegv = Fpoint_min_marker ();
      oldzv = Fpoint_max_marker ();

310
      if (PT == Z)
311
	point_at_end = 1;
312
      if (ZV == Z)
313
	zv_at_end = 1;
314 315 316 317 318 319

      BEGV = BEG;
      BEGV_BYTE = BEG_BYTE;
      ZV = Z;
      ZV_BYTE = Z_BYTE;
      TEMP_SET_PT_BOTH (Z, Z_BYTE);
320 321 322

      /* Insert the string--maybe converting multibyte to single byte
	 or vice versa, so that all the text fits the buffer.  */
323
      if (multibyte
324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339
	  && 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);
	    }
	}
340
      else if (! multibyte
341 342
	       && ! NILP (current_buffer->enable_multibyte_characters))
	{
343
	  int i = 0;
344
	  unsigned char *msg = (unsigned char *) m;
345 346 347 348
	  /* Convert a single-byte string to multibyte
	     for the *Message* buffer.  */
	  while (i < len)
	    {
349
	      int c = unibyte_char_to_multibyte (msg[i++]);
350 351 352 353
	      insert_char (c);
	    }
	}
      else if (len)
354
	insert_1 (m, len, 1, 0, 0);
355

356
      if (nlflag)
Karl Heuer's avatar
Karl Heuer committed
357
	{
358 359 360 361 362 363
	  int this_bol, this_bol_byte, prev_bol, prev_bol_byte, dup;
	  insert_1 ("\n", 1, 1, 0, 0);

	  scan_newline (Z, Z_BYTE, BEG, BEG_BYTE, -2, 0);
	  this_bol = PT;
	  this_bol_byte = PT_BYTE;
364 365 366

	  if (this_bol > BEG)
	    {
367
	      scan_newline (PT, PT_BYTE, BEG, BEG_BYTE, -2, 0);
368 369 370
	      prev_bol = PT;
	      prev_bol_byte = PT_BYTE;

371 372
	      dup = message_log_check_duplicate (prev_bol, prev_bol_byte,
						 this_bol, this_bol_byte);
373 374
	      if (dup)
		{
Karl Heuer's avatar
Karl Heuer committed
375 376
		  del_range_both (prev_bol, prev_bol_byte,
				  this_bol, this_bol_byte, 0);
377 378 379 380 381 382 383 384 385
		  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);
386 387
		      TEMP_SET_PT_BOTH (Z - 1, Z_BYTE - 1);
		      insert_1 (dupstr, duplen, 1, 0, 1);
388 389 390 391 392 393
		    }
		}
	    }

	  if (NATNUMP (Vmessage_log_max))
	    {
394 395
	      scan_newline (Z, Z_BYTE, BEG, BEG_BYTE,
			    -XFASTINT (Vmessage_log_max) - 1, 0);
Karl Heuer's avatar
Karl Heuer committed
396
	      del_range_both (BEG, BEG_BYTE, PT, PT_BYTE, 0);
397
	    }
Karl Heuer's avatar
Karl Heuer committed
398
	}
399 400 401
      BEGV = XMARKER (oldbegv)->charpos;
      BEGV_BYTE = marker_byte_position (oldbegv);

402
      if (zv_at_end)
403 404 405 406
	{
	  ZV = Z;
	  ZV_BYTE = Z_BYTE;
	}
407
      else
408 409 410 411 412
	{
	  ZV = XMARKER (oldzv)->charpos;
	  ZV_BYTE = marker_byte_position (oldzv);
	}

413
      if (point_at_end)
414
	TEMP_SET_PT_BOTH (Z, Z_BYTE);
415
      else
416 417 418 419 420 421
	Fgoto_char (oldpoint);

      free_marker (oldpoint);
      free_marker (oldbegv);
      free_marker (oldzv);

Karl Heuer's avatar
Karl Heuer committed
422
      set_buffer_internal (oldbuf);
423
      windows_or_buffers_changed = old_windows_or_buffers_changed;
424
      message_log_need_newline = !nlflag;
425
      Vdeactivate_mark = old_deactivate_mark;
Karl Heuer's avatar
Karl Heuer committed
426
    }
427 428
}

429 430 431 432 433
/* 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]".  */
434

435
static int
436
message_log_check_duplicate (prev_bol, prev_bol_byte, this_bol, this_bol_byte)
437
     int prev_bol, this_bol;
438
     int prev_bol_byte, this_bol_byte;
439 440 441 442
{
  int i;
  int len = Z - 1 - this_bol;
  int seen_dots = 0;
443 444
  unsigned char *p1 = BUF_BYTE_ADDRESS (current_buffer, prev_bol_byte);
  unsigned char *p2 = BUF_BYTE_ADDRESS (current_buffer, this_bol_byte);
445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466

  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;
}
467

468
/* Display an echo area message M with a specified length of LEN chars.
469
   The string may include null characters.  If M is 0, clear out any
470
   existing message, and let the minibuffer text show through.
471 472 473 474 475 476

   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.  */
477 478

void
479
message2 (m, len, multibyte)
480 481
     char *m;
     int len;
482
     int multibyte;
483 484
{
  /* First flush out any partial line written with print.  */
485
  message_log_maybe_newline ();
486
  if (m)
487 488
    message_dolog (m, len, 1, multibyte);
  message2_nolog (m, len, multibyte);
Karl Heuer's avatar
Karl Heuer committed
489 490 491
}


492
/* The non-logging counterpart of message2.  */
Karl Heuer's avatar
Karl Heuer committed
493 494

void
495
message2_nolog (m, len, multibyte)
Karl Heuer's avatar
Karl Heuer committed
496 497
     char *m;
     int len;
498
{
499
  message_enable_multibyte = multibyte;
500

501 502 503 504 505
  if (noninteractive)
    {
      if (noninteractive_need_newline)
	putc ('\n', stderr);
      noninteractive_need_newline = 0;
506 507
      if (m)
	fwrite (m, len, 1, stderr);
508 509 510 511 512 513 514 515 516
      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))
    {
517 518
      Lisp_Object mini_window;
      FRAME_PTR f;
519

520 521 522 523 524 525
      /* 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);
526
      if (FRAME_VISIBLE_P (selected_frame)
527 528
	  && ! FRAME_VISIBLE_P (f))
	Fmake_frame_visible (WINDOW_FRAME (XWINDOW (mini_window)));
529 530 531 532 533

      if (m)
	{
	  echo_area_glyphs = m;
	  echo_area_glyphs_length = len;
534 535 536

	  if (minibuffer_auto_raise)
	    Fraise_frame  (WINDOW_FRAME (XWINDOW (mini_window)));
537
	}
538 539 540 541 542
      else
	echo_area_glyphs = previous_echo_glyphs = 0;

      do_pending_window_change ();
      echo_area_display ();
543
      update_frame (f, 1, 1);
544
      do_pending_window_change ();
545
      if (frame_up_to_date_hook != 0 && ! gc_in_progress)
546
	(*frame_up_to_date_hook) (f);
547 548
    }
}
549

550 551 552
/* Display in echo area the null-terminated ASCII-only string M.
   If M is 0, clear out any existing message,
   and let the minibuffer text show through.
553

554
   The string M must continue to exist until after the echo area
555 556 557 558
   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.  */
559

560 561 562 563
void
message1 (m)
     char *m;
{
564
  message2 (m, (m ? strlen (m) : 0), 0);
565 566
}

Karl Heuer's avatar
Karl Heuer committed
567 568 569 570
void
message1_nolog (m)
     char *m;
{
571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632
  message2_nolog (m, (m ? strlen (m) : 0), 0);
}

/* Display a message M which contains a single %s
   which gets replaced with STRING.  */

void
message_with_string (m, string, log)
     char *m;
     Lisp_Object string;
     int log;
{
  if (noninteractive)
    {
      if (m)
	{
	  if (noninteractive_need_newline)
	    putc ('\n', stderr);
	  noninteractive_need_newline = 0;
	  fprintf (stderr, m, XSTRING (string)->data);
	  if (cursor_in_echo_area == 0)
	    fprintf (stderr, "\n");
	  fflush (stderr);
	}
    }
  else if (INTERACTIVE)
    {
      /* 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.  */
      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)));

      /* 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 (FRAME_MESSAGE_BUF (f))
	{
	  int len;
	  char *a[1];
	  a[0] = (char *) XSTRING (string)->data;

	  len = doprnt (FRAME_MESSAGE_BUF (f),
			FRAME_MESSAGE_BUF_SIZE (f), m, (char *)0, 3, a);

	  if (log)
	    message2 (FRAME_MESSAGE_BUF (f), len,
		      STRING_MULTIBYTE (string));
	  else
	    message2_nolog (FRAME_MESSAGE_BUF (f), len,
			    STRING_MULTIBYTE (string));

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

635 636 637 638 639 640 641 642 643 644 645 646 647 648
/* 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
649
/* Nonzero if FRAME_MESSAGE_BUF (selected_frame) is being used by print;
Jim Blandy's avatar
Jim Blandy committed
650 651 652
   zero if being used by message.  */
int message_buf_print;

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

Jim Blandy's avatar
Jim Blandy committed
656 657 658 659
/* VARARGS 1 */
void
message (m, a1, a2, a3)
     char *m;
660
     EMACS_INT a1, a2, a3;
Jim Blandy's avatar
Jim Blandy committed
661 662 663
{
  if (noninteractive)
    {
664 665 666 667 668 669
      if (m)
	{
	  if (noninteractive_need_newline)
	    putc ('\n', stderr);
	  noninteractive_need_newline = 0;
	  fprintf (stderr, m, a1, a2, a3);
670 671
	  if (cursor_in_echo_area == 0)
	    fprintf (stderr, "\n");
672 673
	  fflush (stderr);
	}
Jim Blandy's avatar
Jim Blandy committed
674
    }
675
  else if (INTERACTIVE)
Jim Blandy's avatar
Jim Blandy committed
676
    {
677 678 679
      /* 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.  */
680 681 682 683 684 685 686
      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)));
687 688 689 690

      /* 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.  */
691
      if (FRAME_MESSAGE_BUF (f))
692
	{
693 694
	  if (m)
	    {
695
	      int len;
Jim Blandy's avatar
Jim Blandy committed
696
#ifdef NO_ARG_ARRAY
697 698 699 700
	      char *a[3];
	      a[0] = (char *) a1;
	      a[1] = (char *) a2;
	      a[2] = (char *) a3;
Jim Blandy's avatar
Jim Blandy committed
701

702
	      len = doprnt (FRAME_MESSAGE_BUF (f),
703
			    FRAME_MESSAGE_BUF_SIZE (f), m, (char *)0, 3, a);
Jim Blandy's avatar
Jim Blandy committed
704
#else
705
	      len = doprnt (FRAME_MESSAGE_BUF (f),
706 707
			    FRAME_MESSAGE_BUF_SIZE (f), m, (char *)0, 3,
			    (char **) &a1);
708 709
#endif /* NO_ARG_ARRAY */

710
	      message2 (FRAME_MESSAGE_BUF (f), len, 0);
711 712 713 714 715 716 717
	    }
	  else
	    message1 (0);

	  /* Print should start at the beginning of the message
	     buffer next time.  */
	  message_buf_print = 0;
718
	}
Jim Blandy's avatar
Jim Blandy committed
719 720 721
    }
}

722
/* The non-logging version of message.  */
Karl Heuer's avatar
Karl Heuer committed
723 724 725 726 727 728 729 730 731 732 733 734
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;
}

735 736 737
void
update_echo_area ()
{
738 739
  message2 (echo_area_glyphs, echo_area_glyphs_length,
	    ! NILP (current_buffer->enable_multibyte_characters));
740
}
741

Jim Blandy's avatar
Jim Blandy committed
742 743 744 745
static void
echo_area_display ()
{
  register int vpos;
Jim Blandy's avatar
Jim Blandy committed
746
  FRAME_PTR f;
747
  Lisp_Object mini_window;
Jim Blandy's avatar
Jim Blandy committed
748

749 750 751 752 753
  /* 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
754

Jim Blandy's avatar
Jim Blandy committed
755
  if (! FRAME_VISIBLE_P (f))
Jim Blandy's avatar
Jim Blandy committed
756 757
    return;

Jim Blandy's avatar
Jim Blandy committed
758
  if (frame_garbaged)
Jim Blandy's avatar
Jim Blandy committed
759
    {
760
      redraw_garbaged_frames ();
Jim Blandy's avatar
Jim Blandy committed
761
      frame_garbaged = 0;
Jim Blandy's avatar
Jim Blandy committed
762 763 764 765
    }

  if (echo_area_glyphs || minibuf_level == 0)
    {
766 767
      int i;

768 769 770
      echo_area_window = mini_window;

      vpos = XFASTINT (XWINDOW (mini_window)->top);
Jim Blandy's avatar
Jim Blandy committed
771
      get_display_line (f, vpos, 0);
772 773 774 775 776 777

      /* 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;

778
      display_string (XWINDOW (mini_window), vpos,
Jim Blandy's avatar
Jim Blandy committed
779
		      echo_area_glyphs ? echo_area_glyphs : "",
780
		      echo_area_glyphs ? echo_area_glyphs_length : -1,
781
		      FRAME_LEFT_SCROLL_BAR_WIDTH (f),
782
		      0, 0, 0,
783 784
		      FRAME_WIDTH (f) + FRAME_LEFT_SCROLL_BAR_WIDTH (f),
		      message_enable_multibyte);
Jim Blandy's avatar
Jim Blandy committed
785

786
#if 0 /* This just gets in the way.  update_frame does the job.  */
Jim Blandy's avatar
Jim Blandy committed
787
      /* If desired cursor location is on this line, put it at end of text */
788 789
      if (cursor_in_echo_area)
	FRAME_CURSOR_Y (f) = vpos;
Jim Blandy's avatar
Jim Blandy committed
790 791
      if (FRAME_CURSOR_Y (f) == vpos)
	FRAME_CURSOR_X (f) = FRAME_DESIRED_GLYPHS (f)->used[vpos];
792
#endif
Jim Blandy's avatar
Jim Blandy committed
793 794 795 796 797

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

798
	for (i = vpos + 1;
799
	     i < vpos + XFASTINT (XWINDOW (mini_window)->height); i++)
Jim Blandy's avatar
Jim Blandy committed
800
	  {
Jim Blandy's avatar
Jim Blandy committed
801
	    get_display_line (f, i, 0);
802 803 804
	    /* 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.  */
805
	    display_string (XWINDOW (mini_window), i,
806
			    "", 0, 
807
                            0, 0, 0,
808 809
                            0, FRAME_WIDTH (f) + FRAME_SCROLL_BAR_WIDTH (f),
			    0);
Jim Blandy's avatar
Jim Blandy committed
810 811
	  }
      }
Jim Blandy's avatar
Jim Blandy committed
812
    }
813
  else if (!EQ (mini_window, selected_window))
Jim Blandy's avatar
Jim Blandy committed
814 815
    windows_or_buffers_changed++;

816
  if (EQ (mini_window, selected_window))
Jim Blandy's avatar
Jim Blandy committed
817 818 819 820
    this_line_bufpos = 0;

  previous_echo_glyphs = echo_area_glyphs;
}
821 822

/* Update frame titles.  */
823

824
#ifdef HAVE_WINDOW_SYSTEM
825 826
static char frame_title_buf[512];
static char *frame_title_ptr;
827

828 829 830 831 832 833 834 835 836 837 838 839 840 841 842
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;
}
843 844 845 846 847

static void
x_consider_frame_title (frame)
     Lisp_Object frame;
{
848 849 850
  Lisp_Object fmt;
  struct buffer *obuf;
  int len;
851 852
  FRAME_PTR f = XFRAME (frame);

853
  if (!(FRAME_WINDOW_P (f) || FRAME_MINIBUF_ONLY_P (f) || f->explicit_name))
854
    return;
855 856 857 858 859 860 861 862 863

  /* 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);

864 865
	if (tf != f && FRAME_KBOARD (tf) == FRAME_KBOARD (f)
	    && !FRAME_MINIBUF_ONLY_P (tf)
866 867 868 869 870 871 872
	    && (FRAME_VISIBLE_P (tf) || FRAME_ICONIFIED_P (tf)))
	  break;
      }

    multiple_frames = CONSP (tail);
  }

873 874 875 876 877 878 879 880 881 882 883 884 885
  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.)  */
886
  if (! STRINGP (f->name) || STRING_BYTES (XSTRING (f->name)) != len
887 888
      || bcmp (frame_title_buf, XSTRING (f->name)->data, len) != 0)
    x_implicitly_set_name (f, make_string (frame_title_buf, len), Qnil);
889
}
890 891
#else
#define frame_title_ptr ((char *)0)
892
#define store_frame_title(str, mincol, maxcol) 0
893
#endif
Jim Blandy's avatar
Jim Blandy committed
894

895
/* Prepare for redisplay by updating menu-bar item lists when appropriate.
Richard M. Stallman's avatar
Richard M. Stallman committed
896
   This can call eval.  */
897 898 899 900 901 902

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

905
  all_windows = (update_mode_lines || buffer_shared > 1
906
		 || windows_or_buffers_changed);
907

908 909 910 911 912 913 914 915 916 917
  /* 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.  */
918
#ifdef HAVE_WINDOW_SYSTEM
919
  if (windows_or_buffers_changed || update_mode_lines)
920 921 922 923 924 925 926 927 928 929
    {
      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

930 931 932 933 934 935
  /* 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;
936 937
      int count = specpdl_ptr - specpdl;

938
      record_unwind_protect (Fset_match_data, Fmatch_data (Qnil, Qnil));
939 940

      FOR_EACH_FRAME (tail, frame)
941 942 943 944 945 946
	{
	  /* 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;
947 948
	      /* Clear flag first in case we get error below.  */
	      FRAME_WINDOW_SIZES_CHANGED (XFRAME (frame)) = 0;
949 950 951 952 953 954 955 956 957 958
	      functions = Vwindow_size_change_functions;
	      GCPRO2 (tail, functions);
	      while (CONSP (functions))
		{
		  call1 (XCONS (functions)->car, frame);
		  functions = XCONS (functions)->cdr;
		}
	      UNGCPRO;
	    }
	  GCPRO1 (tail);
959
	  update_menu_bar (XFRAME (frame), 0);
960 961
	  UNGCPRO;
	}
962 963

      unbind_to (count, Qnil);
964
    }
965
  else
966
    update_menu_bar (selected_frame, 1);
967 968 969 970 971 972

  /* 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
973 974
}

Jim Blandy's avatar
Jim Blandy committed
975
/* Do a frame update, taking possible shortcuts into account.
Jim Blandy's avatar
Jim Blandy committed
976 977 978 979 980 981
   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.

982 983 984 985 986 987
   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
988
   or with synchronous processes running.
989

Jim Blandy's avatar
Jim Blandy committed
990 991 992
   See Fcall_process; if you called it from here, it could be
   entered recursively.  */

993 994
static int do_verify_charstarts;

995 996 997 998
/* Counter is used to clear the face cache
   no more than once ever 1000 redisplays.  */
static int clear_face_cache_count;

999 1000 1001
/* Record the previous terminal frame we displayed.  */
static FRAME_PTR previous_terminal_frame;

Jim Blandy's avatar
Jim Blandy committed
1002 1003
void
redisplay ()
1004 1005 1006 1007 1008 1009
{
  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
1010 1011
   preserve the echo area.  (Actually, our caller does that job.)
   Perhaps in the future avoid recentering windows
1012 1013 1014 1015 1016
   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
1017 1018 1019 1020 1021 1022 1023
{
  register struct window *w = XWINDOW (selected_window);
  register int pause;
  int must_finish = 0;
  int all_windows;
  register int tlbufpos, tlendpos;
  struct position pos;
1024
  int number_of_visible_frames;
Jim Blandy's avatar
Jim Blandy committed
1025 1026 1027 1028

  if (noninteractive)
    return;

1029 1030 1031 1032 1033
#ifdef USE_X_TOOLKIT
  if (popup_activated ())
    return;
#endif

1034 1035
 retry:

1036
  if (! FRAME_WINDOW_P (selected_frame)
1037 1038 1039 1040 1041 1042 1043 1044 1045 1046
      && 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;

1047 1048 1049 1050 1051
  /* 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.  */
  {
1052
    Lisp_Object tail, frame;
1053

1054 1055
    number_of_visible_frames = 0;

1056
    FOR_EACH_FRAME (tail, frame)
1057 1058 1059
      {
	FRAME_SAMPLE_VISIBILITY (XFRAME (frame));

1060 1061
	if (FRAME_VISIBLE_P (XFRAME (frame)))
	  number_of_visible_frames++;
1062

1063 1064 1065 1066
	/* Clear out all the display lines in which we will generate the
	   glyphs to display.  */
	init_desired_glyphs (XFRAME (frame));
      }
1067 1068
  }

Jim Blandy's avatar
Jim Blandy committed
1069
  /* Notice any pending interrupt request to change frame size.  */
Jim Blandy's avatar
Jim Blandy committed
1070 1071
  do_pending_window_change ();

Jim Blandy's avatar
Jim Blandy committed
1072
  if (frame_garbaged)
Jim Blandy's avatar
Jim Blandy committed
1073
    {
1074
      redraw_garbaged_frames ();
Jim Blandy's avatar
Jim Blandy committed
1075
      frame_garbaged = 0;
Jim Blandy's avatar
Jim Blandy committed
1076 1077
    }

1078 1079
  prepare_menu_bars ();

1080
  if (windows_or_buffers_changed)
Jim Blandy's avatar
Jim Blandy committed
1081 1082
    update_mode_lines++;

1083 1084
  /* Detect case that we need to write or remove a star in the mode line.  */
  if ((SAVE_MODIFF < MODIFF) != !NILP (w->last_had_star))