Mercurial > hg > xemacs-beta

comparison man/lispref/extents.texi @ 412:697ef44129c6 r21-2-14

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import from CVS: tag r21-2-14
author cvs
date Mon, 13 Aug 2007 11:20:41 +0200
parents 501cfd01ee6d
children
comparison
equal deleted inserted replaced
411:12e008d41344 412:697ef44129c6
92 are used to implement annotations, and you should use the annotation API 92 are used to implement annotations, and you should use the annotation API
93 functions in preference to the lower-level extent functions. For more 93 functions in preference to the lower-level extent functions. For more
94 information, @xref{Annotations}. 94 information, @xref{Annotations}.
95 95
96 If an extent has its @code{detachable} property set, it will become 96 If an extent has its @code{detachable} property set, it will become
97 @dfn{detached} (i.e. no longer in the buffer) when all its text is 97 @dfn{detached} (i.e. no longer in the buffer) when all its text its
98 deleted. Otherwise, it will simply shrink down to zero-length and 98 deleted. Otherwise, it will simply shrink down to zero-length and
99 sit in the same place in the buffer. By default, the @code{detachable} 99 sit it the same place in the buffer. By default, the @code{detachable}
100 property is set on newly-created extents. @xref{Detached Extents}. 100 property is set on newly-created extents. @xref{Detached Extents}.
101 101
102 If an extent has its @code{duplicable} property set, it will be 102 If an extent has its @code{duplicable} property set, it will be
103 remembered when a string is created from text bounded by the extent. 103 remembered when a string is created from text bounded by the extent.
104 When the string is re-inserted into a buffer, the extent will also 104 When the string is re-inserted into a buffer, the extent will also
284 control. 284 control.
285 @end defun 285 @end defun
286 286
287 The following low-level functions are provided for explicitly 287 The following low-level functions are provided for explicitly
288 traversing the extents in a buffer according to the display order. 288 traversing the extents in a buffer according to the display order.
289 These functions are mostly intended for debugging---in normal 289 These functions are mostly intended for debugging -- in normal
290 operation, you should probably use @code{mapcar-extents} or 290 operation, you should probably use @code{mapcar-extents} or
291 @code{map-extents}, or loop using the @var{before} argument to 291 @code{map-extents}, or loop using the @var{before} argument to
292 @code{extent-at}, rather than creating a loop using @code{next-extent}. 292 @code{extent-at}, rather than creating a loop using @code{next-extent}.
293 293
294 @defun next-extent extent 294 @defun next-extent extent
776 become visible again.) 776 become visible again.)
777 777
778 It is possible for an extent's parent to itself have a parent, 778 It is possible for an extent's parent to itself have a parent,
779 and so on. Through this, a whole tree of extents can be created, 779 and so on. Through this, a whole tree of extents can be created,
780 all deriving their properties from one root extent. Note, however, 780 all deriving their properties from one root extent. Note, however,
781 that you cannot create an inheritance loop---this is explicitly 781 that you cannot create an inheritance loop -- this is explicitly
782 disallowed. 782 disallowed.
783 783
784 Parent extents are used to implement the extents over the modeline. 784 Parent extents are used to implement the extents over the modeline.
785 785
786 @defun set-extent-parent extent parent 786 @defun set-extent-parent extent parent