---

10.5 Redisplay

Redisplay translates changes in the internal representation of text into changes on the screen. Ideally this process finds the minimal transformation to make the screen correspond to the text in order to maximize the speed of redisplay.

Hemlock Variable: Redisplay Hook ¶

Function: redisplay ¶

redisplay executes the redisplay process, and Hemlock typically invokes this whenever it looks for input. The redisplay process frequently checks for input, and if it detects any, it aborts. The return value is interpreted as follows:

nil

No update was needed.

t

Update was needed, and completed successfully.

:editor-input

Update is needed, but was aborted due to pending input.

This function invokes the functions in Redisplay Hook on the current window after computing screen transformations but before executing them. After invoking the hook, this recomputes the redisplay and then executes it on the current window.

For the current window and any window with window-display-recentering set, redisplay ensures the buffer’s point for the window’s buffer is visible after redisplay.

Function: redisplay-all ¶

This causes all editor windows to be completely redisplayed. For the current window and any window with window-display-recentering set, this ensures the buffer’s point for the window’s buffer is visible after redisplay. The return values are the same as for redisplay, except that nil is never returned.

Function: editor-finish-output window ¶

This makes sure the editor is synchronized with respect to redisplay output to window. This may do nothing on some devices.