Mercurial > hg > xemacs-beta

comparison man/lispref/specifiers.texi @ 1138:05ed51332340

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[xemacs-hg @ 2002-12-03 11:01:40 by didierv] Fixes in two texi files
author didierv
date Tue, 03 Dec 2002 11:01:44 +0000
parents 9eddcb9548e2
children 11812ec0334c
comparison
equal deleted inserted replaced
1137:c6facab13185 1138:05ed51332340
49 @node Introduction to Specifiers 49 @node Introduction to Specifiers
50 @section Introduction to Specifiers 50 @section Introduction to Specifiers
51 51
52 Perhaps the most useful way to explain specifiers is via an analogy. 52 Perhaps the most useful way to explain specifiers is via an analogy.
53 Emacs Lisp programmers are used to @emph{buffer-local variables} 53 Emacs Lisp programmers are used to @emph{buffer-local variables}
54 @ref{buffer-local variables}. For example, the variable 54 @ref{Buffer-Local Variables}. For example, the variable
55 @code{modeline-format}, which controls the format of the modeline, can 55 @code{modeline-format}, which controls the format of the modeline, can
56 have different values depending on the particular buffer being edited. 56 have different values depending on the particular buffer being edited.
57 The variable has a default value which most modes will use, but a 57 The variable has a default value which most modes will use, but a
58 specialized package such as Calendar might change the variable so as 58 specialized package such as Calendar might change the variable so as to
59 to tailor the modeline to its own purposes. Other variables are 59 tailor the modeline to its own purposes. Other variables are perhaps
60 perhaps best thought of as ``mode local,'' such as font-lock keywords, 60 best thought of as ``mode local,'' such as font-lock keywords, but they
61 but they are implemented as buffer locals. 61 are implemented as buffer locals.
62 62
63 Other properties (such as those that can be changed by the 63 Other properties (such as those that can be changed by the
64 @code{modify-frame-parameters} function, for example the color of the 64 @code{modify-frame-parameters} function, for example the color of the
65 text cursor) can have frame-local values, although it might also make 65 text cursor) can have frame-local values, although it might also make
66 sense for them to have buffer-local values. In other cases, you might 66 sense for them to have buffer-local values. In other cases, you might
259 (For toolbars, the code above should work 99% of the time, because 259 (For toolbars, the code above should work 99% of the time, because
260 toolbars are rarely changed. Since instantiation is trivial, multiple 260 toolbars are rarely changed. Since instantiation is trivial, multiple
261 specs are not useful---the first one always succeeds.) 261 specs are not useful---the first one always succeeds.)
262 262
263 In fact, @code{specifier-specs} is intended to be used to display specs 263 In fact, @code{specifier-specs} is intended to be used to display specs
264 to humans with a minimum of clutter. The robust way to access 264 to humans with a minimum of clutter. The robust way to access
265 specifications is via @code{specifier-spec-list}. @xref{Adding 265 specifications is via @code{specifier-spec-list}. @xref{Adding
266 Specifications}, for the definition of @dfn{spec-list}. 266 Specifications}, for the definition of @dfn{spec-list}. @xref{Retrieving
267 @xref{Retrieving Specifications} for documentation of 267 Specifications}, for documentation of @code{specifier-specs} and
268 @code{specifier-specs} and @code{specifier-spec-list}. To get the 268 @code{specifier-spec-list}. To get the desired effect, replace the form
269 desired effect, replace the form @code{(specifier-spec default-toolbar 269 @code{(specifier-spec default-toolbar 'global)} with
270 'global)} with
271 270
272 @example 271 @example
273 (cdr (second (first (specifier-spec-list default-toolbar 'global)))) 272 (cdr (second (first (specifier-spec-list default-toolbar 'global))))
274 @end example 273 @end example
275 274
1361 @end defun 1360 @end defun
1362 1361
1363 @defun specifier-locale-type-from-locale locale 1362 @defun specifier-locale-type-from-locale locale
1364 Given a specifier @var{locale}, this function returns its type. 1363 Given a specifier @var{locale}, this function returns its type.
1365 @end defun 1364 @end defun
1366