Mercurial > emacs

comparison src/xdisp.c @ 40546:361c85774b8f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Fix typos in comments.
author Pavel Janík <Pavel@Janik.cz>
date Wed, 31 Oct 2001 10:32:57 +0000
parents 0b1d7078c080
children cdfd4d09b79a
comparison
equal deleted inserted replaced
40545:0b1d7078c080 40546:361c85774b8f
31 Updating the display is triggered by the Lisp interpreter when it 31 Updating the display is triggered by the Lisp interpreter when it
32 decides it's time to do it. This is done either automatically for 32 decides it's time to do it. This is done either automatically for
33 you as part of the interpreter's command loop or as the result of 33 you as part of the interpreter's command loop or as the result of
34 calling Lisp functions like `sit-for'. The C function `redisplay' 34 calling Lisp functions like `sit-for'. The C function `redisplay'
35 in xdisp.c is the only entry into the inner redisplay code. (Or, 35 in xdisp.c is the only entry into the inner redisplay code. (Or,
36 let's say almost---see the the description of direct update 36 let's say almost---see the description of direct update
37 operations, below.). 37 operations, below.).
38 38
39 The following diagram shows how redisplay code is invoked. As you 39 The following diagram shows how redisplay code is invoked. As you
40 can see, Lisp calls redisplay and vice versa. Under window systems 40 can see, Lisp calls redisplay and vice versa. Under window systems
41 like X, some portions of the redisplay code are also called 41 like X, some portions of the redisplay code are also called
86 reusing part of the display by scrolling lines. 86 reusing part of the display by scrolling lines.
87 87
88 88
89 Direct operations. 89 Direct operations.
90 90
91 You will find a lot of of redisplay optimizations when you start 91 You will find a lot of redisplay optimizations when you start
92 looking at the innards of redisplay. The overall goal of all these 92 looking at the innards of redisplay. The overall goal of all these
93 optimizations is to make redisplay fast because it is done 93 optimizations is to make redisplay fast because it is done
94 frequently. 94 frequently.
95 95
96 Two optimizations are not found in xdisp.c. These are the direct 96 Two optimizations are not found in xdisp.c. These are the direct
121 properties, on display tables, on selective display. The good news 121 properties, on display tables, on selective display. The good news
122 is that all this hairy stuff is hidden behind a small set of 122 is that all this hairy stuff is hidden behind a small set of
123 interface functions taking a iterator structure (struct it) 123 interface functions taking a iterator structure (struct it)
124 argument. 124 argument.
125 125
126 Iteration over things to be be displayed is then simple. It is 126 Iteration over things to be displayed is then simple. It is
127 started by initializing an iterator with a call to init_iterator. 127 started by initializing an iterator with a call to init_iterator.
128 Calls to get_next_display_element fill the iterator structure with 128 Calls to get_next_display_element fill the iterator structure with
129 relevant information about the next thing to display. Calls to 129 relevant information about the next thing to display. Calls to
130 set_iterator_to_next move the iterator to the next thing. 130 set_iterator_to_next move the iterator to the next thing.
131 131