Function: redisplay

redisplay is a function defined in dispnew.c.

Signature

(redisplay &optional FORCE)

Documentation

Perform redisplay.

Optional arg FORCE, if non-nil, prevents redisplay from being preempted by arriving input, even if redisplay-dont-pause is nil. If redisplay-dont-pause is non-nil (the default), redisplay is never preempted by arriving input, so FORCE does nothing.

Return t if redisplay was performed, nil if redisplay was preempted immediately by pending input.

Probably introduced at or before Emacs version 1.9.

Source Code

// Defined in /usr/src/emacs/src/dispnew.c
{
  ptrdiff_t count;

  swallow_events (true);
  if ((detect_input_pending_run_timers (1)
       && NILP (force) && !redisplay_dont_pause)
      || !NILP (Vexecuting_kbd_macro))
    return Qnil;

  count = SPECPDL_INDEX ();
  if (!NILP (force) && !redisplay_dont_pause)
    specbind (Qredisplay_dont_pause, Qt);
  redisplay_preserve_echo_area (2);
  return unbind_to (count, Qt);
}