; * src/xdisp.c: Minor improvements of the commentary.

This commit is contained in:
Eli Zaretskii 2023-07-18 14:58:09 +03:00
parent ce3f9fba1a
commit 77f489421e

View file

@ -107,31 +107,33 @@ along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>. */
. try_cursor_movement . try_cursor_movement
This function tries to update the display if the text in the This optimization is applicable if the text in the window did
window did not change and did not scroll, only point moved, and not change and did not scroll, only point moved, and it did not
it did not move off the displayed portion of the text. move off the displayed portion of the text. In that case, the
window's glyph matrix is still valid, and only the position of
the cursor might need to be updated.
. try_window_reusing_current_matrix . try_window_reusing_current_matrix
This function reuses the current matrix of a window when text This function reuses the current glyph matrix of a window when
has not changed, but the window start changed (e.g., due to text has not changed, but the window start changed (e.g., due to
scrolling). scrolling).
. try_window_id . try_window_id
This function attempts to redisplay a window by reusing parts of This function attempts to update a window's glyph matrix by
its existing display. It finds and reuses the part that was not reusing parts of its current glyph matrix. It finds and reuses
changed, and redraws the rest. (The "id" part in the function's the part that was not changed, and regenerates the rest. (The
name stands for "insert/delete", not for "identification" or "id" part in the function's name stands for "insert/delete", not
somesuch.) for "identification" or somesuch.)
. try_window . try_window
This function performs the full, unoptimized, redisplay of a This function performs the full, unoptimized, generation of a
single window assuming that its fonts were not changed and that single window's glyph matrix, assuming that its fonts were not
the cursor will not end up in the scroll margins. (Loading changed and that the cursor will not end up in the scroll
fonts requires re-adjustment of dimensions of glyph matrices, margins. (Loading fonts requires re-adjustment of dimensions of
which makes this method impossible to use.) glyph matrices, which makes this method impossible to use.)
The optimizations are tried in sequence (some can be skipped if The optimizations are tried in sequence (some can be skipped if
it is known that they are not applicable). If none of the it is known that they are not applicable). If none of the