@c See the file lispref.texi for copying conditions.
@setfilename ../../info/faces.info
-@node Faces and Window-System Objects, Glyphs, Specifiers, top
+@node Faces and Window-System Objects, Glyphs, Specifiers, Top
@chapter Faces and Window-System Objects
@cindex faces
@cindex window-system objects
@end menu
-@node Faces
+@node Faces, Fonts, Faces and Window-System Objects, Faces and Window-System Objects
@section Faces
A @dfn{face} is a named collection of graphical properties: font,
@end menu
-@node Merging Faces
+@node Merging Faces, Basic Face Functions, Faces, Faces
@subsection Merging Faces for Display
Here are all the ways to specify which face to use for display of text:
used to color it.
-@node Basic Face Functions
+@node Basic Face Functions, Face Properties, Merging Faces, Faces
@subsection Basic Functions for Working with Faces
The properties a face can specify include the font, the foreground
@end defun
-@node Face Properties
+@node Face Properties, Face Convenience Functions, Basic Face Functions, Faces
@subsection Face Properties
You can examine and modify the properties of an existing face with the
to this property can be supplied in many different ways:
@itemize @bullet
+
+@item
If @var{value} is a simple instantiator (e.g. a string naming a font or
color) or a list of instantiators, then the instantiator(s) will be
added as a specification of the property for the given @var{locale}
(which defaults to @code{global} if omitted).
+@item
If @var{value} is a list of specifications (each of which is a cons of a
locale and a list of instantiators), then @var{locale} must be
@code{nil} (it does not make sense to explicitly specify a locale in
this case), and specifications will be added as given.
+@item
If @var{value} is a specifier (as would be returned by
@code{face-property} if no @var{locale} argument is given), then some or
all of the specifications in the specifier will be added to the
@end defun
-@node Face Convenience Functions
+@node Face Convenience Functions, Other Face Display Functions, Face Properties, Faces
@subsection Face Convenience Functions
@deffn Command set-face-foreground face color &optional locale tag-set how-to-add
@end defun
-@node Other Face Display Functions
+@node Other Face Display Functions, , Face Convenience Functions, Faces
@subsection Other Face Display Functions
@deffn Command invert-face face &optional locale
@end defun
-@node Fonts
+@node Fonts, Colors, Faces, Faces and Window-System Objects
@section Fonts
@cindex fonts
@end menu
-@node Font Specifiers
+@node Font Specifiers, Font Instances, Fonts, Fonts
@subsection Font Specifiers
@defun font-specifier-p object
@end defun
-@node Font Instances
+@node Font Instances, Font Instance Names, Font Specifiers, Fonts
@subsection Font Instances
@defun font-instance-p object
@end defun
-@node Font Instance Names
+@node Font Instance Names, Font Instance Size, Font Instances, Fonts
@subsection Font Instance Names
@cindex font instance name
@cindex available fonts
@end defun
-@node Font Instance Size
+@node Font Instance Size, Font Instance Characteristics, Font Instance Names, Fonts
@subsection Font Instance Size
@cindex font instance size
@end defun
-@node Font Instance Characteristics
+@node Font Instance Characteristics, Font Convenience Functions, Font Instance Size, Fonts
@subsection Font Instance Characteristics
@cindex font instance characteristics
@cindex characteristics of font instances
@end defun
-@node Font Convenience Functions
+@node Font Convenience Functions, , Font Instance Characteristics, Fonts
@subsection Font Convenience Functions
@defun font-name font &optional domain
@end defun
-@node Colors
+@node Colors, , Fonts, Faces and Window-System Objects
@section Colors
@cindex colors
@end menu
-@node Color Specifiers
+@node Color Specifiers, Color Instances, Colors, Colors
@subsection Color Specifiers
@defun color-specifier-p object
@end defun
-@node Color Instances
+@node Color Instances, Color Instance Properties, Color Specifiers, Colors
@subsection Color Instances
@cindex color instances
@end defun
-@node Color Instance Properties
+@node Color Instance Properties, Color Convenience Functions, Color Instances, Colors
@subsection Color Instance Properties
@defun color-instance-name color-instance
@end example
@end defun
-@node Color Convenience Functions
+@node Color Convenience Functions, , Color Instance Properties, Colors
@subsection Color Convenience Functions
@defun color-name color &optional domain