An annotation is a pixmap or string that is not part of a buffer’s text but is displayed next to a particular location in a buffer. Annotations can be displayed intermixed with text, in any whitespace at the beginning or end of a line, or in a special area at the left or right side of the frame called a margin, whose size is controllable. Annotations are implemented using extents (see Extents); but you can work with annotations without knowing how extents work.
| • Annotation Basics: | Introduction to annotations. | |
| • Annotation Primitives: | Creating and deleting annotations. | |
| • Annotation Properties: | Retrieving and changing the characteristics of an annotation. | |
| • Margin Primitives: | Controlling the size of the margins. | |
| • Locating Annotations: | Looking for annotations in a buffer. | |
| • Annotation Hooks: | Hooks called at certain times during an annotation’s lifetime. |