Next: , Previous: , Up: Gutter   [Contents][Index]


30.3 Gutter Descriptor Format

The contents of a gutter are specified using a gutter descriptor. The format of a gutter descriptor is a list of gutter button descriptors. Each gutter button descriptor is a vector in one of the following formats:

Optionally, one of the gutter button descriptors may be nil instead of a vector; this signifies the division between the gutter buttons that are to be displayed flush-left, and the buttons to be displayed flush-right.

The first vector format above specifies a normal gutter button; the others specify blank areas in the gutter.

For the first vector format:

For the other vector formats (specifying blank areas of the gutter):

Function: gutter-make-button-list up &optional down disabled cap-up cap-down cap-disabled

This function calls make-glyph on each arg and returns a list of the results. This is useful for setting the first argument of a gutter button descriptor (typically, the result of this function is assigned to a symbol, which is specified as the first argument of the gutter button descriptor).

Function: check-gutter-button-syntax button &optional noerror

Verify the syntax of entry button in a gutter description list. If you want to verify the syntax of a gutter description list as a whole, use check-valid-instantiator with a specifier type of gutter.


Next: , Previous: , Up: Gutter   [Contents][Index]