comparison src/specifier.c @ 3674:f200f93c0b69

[xemacs-hg @ 2006-11-11 16:05:31 by aidan] Update some documentation, comments; add some entries to etc/NEWS.
author aidan
date Sat, 11 Nov 2006 16:05:39 +0000
parents 887d4be44334
children efca49973324
comparison
equal deleted inserted replaced
3673:887d4be44334 3674:f200f93c0b69
3239 e.g., a buffer-local display table that only gives values for particular 3239 e.g., a buffer-local display table that only gives values for particular
3240 characters. All other characters are handled as if the buffer-local 3240 characters. All other characters are handled as if the buffer-local
3241 display table is not there. (Chartable specifiers are not yet 3241 display table is not there. (Chartable specifiers are not yet
3242 implemented.) 3242 implemented.)
3243 3243
3244 -- For font specifiers, MATCHSPEC should be a list (CHARSET . SECOND-STAGE-P), 3244 -- For font specifiers, MATCHSPEC should be a cons (CHARSET . STAGE).
3245 and the specification (a font string) must have a registry that matches 3245 The defined stages are currently `initial' and `final'. On X11, 'initial
3246 the charset's registry. (This only makes sense with Mule support.) This 3246 is used when the font matching process is looking for fonts that match
3247 makes it easy to choose a font that can display a particular 3247 the desired registries of the charset--see the `charset-registries'
3248 character. (This is what redisplay does, in fact.) SECOND-STAGE-P means 3248 function. If that match process fails, then the 'final stage comes into
3249 to ignore the font's registry and instead look at the characters in the 3249 play; this means that a more general lookup is desired, and that a font
3250 font to see if the font can support the charset. This currently only makes 3250 doesn't necessarily have to match the desired XLFD for the face, just the
3251 sense under MS Windows. 3251 charset repertoire for this charset. It also means that the charset
3252 registry and encoding used will be `iso10646-1', and the characters will
3253 be converted to display using that registry.
3254
3255 See `define-specifier-tag' for details on how to create a tag that
3256 specifies a given character set and stage combination. You can supply
3257 such a tag to `set-face-font' in order to set a face's font for that
3258 character set and stage combination.
3252 */ 3259 */
3253 (specifier, matchspec, domain, default_, no_fallback)) 3260 (specifier, matchspec, domain, default_, no_fallback))
3254 { 3261 {
3255 return specifier_matching_foo (specifier, matchspec, domain, default_, 3262 return specifier_matching_foo (specifier, matchspec, domain, default_,
3256 no_fallback, 0); 3263 no_fallback, 0);