Next: Specifier Validation Functions, Previous: Specifier Examples, Up: Specifiers [Contents][Index]
This function creates a new specifier.
A specifier is an object that can be used to keep track of a property
whose value can be per-buffer, per-window, per-frame, or per-device,
and can further be restricted to a particular device-type or device-class.
Specifiers are used, for example, for the various built-in properties of a
face; this allows a face to have different values in different frames,
buffers, etc. For more information, see specifier-instance
,
specifier-specs
, and add-spec-to-specifier
; or, for a detailed
description of specifiers, including how they are instantiated over a
particular domain (i.e. how their value in that domain is determined),
see the chapter on specifiers in the SXEmacs Lisp Reference Manual.
type specifies the particular type of specifier, and should be one
of the symbols generic
, integer
, natnum
,
boolean
, color
, font
, image
,
face-boolean
, or toolbar
.
For more information on particular types of specifiers, see the
functions make-generic-specifier
, make-integer-specifier
,
make-natnum-specifier
, make-boolean-specifier
,
make-color-specifier
, make-font-specifier
,
make-image-specifier
, make-face-boolean-specifier
, and
make-toolbar-specifier
.
This function creates and initializes a new specifier.
This is a convenience API combining make-specifier
and
set-specifier
that allows you to create
a specifier and add specs to it at the same time. type specifies
the specifier type. Allowed types are as for make-specifier
.
spec-list supplies the specification(s) to be
added to the specifier. Any abbreviation of
the full spec-list form accepted by canonicalize-spec-list
may
be used.
However, if the optional argument dont-canonicalize is non-nil
,
canonicalization is not performed, and the spec-list must already
be in full form.
Return a new integer
specifier object with the given
specification list. spec-list can be a list of specifications
(each of which is a cons of a locale and a list of instantiators), a
single instantiator, or a list of instantiators.
Valid instantiators for integer specifiers are integers.
Return a new boolean
specifier object with the given
specification list. spec-list can be a list of specifications
(each of which is a cons of a locale and a list of instantiators), a
single instantiator, or a list of instantiators.
Valid instantiators for boolean specifiers are t
and nil
.
Return a new natnum
specifier object with the given specification
list. spec-list can be a list of specifications (each of which is
a cons of a locale and a list of instantiators), a single instantiator,
or a list of instantiators.
Valid instantiators for natnum specifiers are non-negative integers.
Return a new generic
specifier object with the given
specification list. spec-list can be a list of specifications
(each of which is a cons of a locale and a list of instantiators), a
single instantiator, or a list of instantiators.
Valid instantiators for generic specifiers are all Lisp values. They are returned back unchanged when a specifier is instantiated.
Return a new display-table
specifier object with the given spec
list. spec-list can be a list of specifications (each of which is
a cons of a locale and a list of instantiators), a single instantiator,
or a list of instantiators.
Valid instantiators for display-table specifiers are described in detail
in the doc string for current-display-table
(see Active Display Table).
Next: Specifier Validation Functions, Previous: Specifier Examples, Up: Specifiers [Contents][Index]