File: face-remap.el.html

This file defines some simple operations that can be used for maintaining the face-remapping-alist in a cooperative way. This is especially important for the default face.

Each face-remapping definition in face-remapping-alist added by this code uses the form:

  (face RELATIVE_SPECS_1 RELATIVE_SPECS_2 ... BASE_SPECS)

The "specs" values are lists of face names or face attribute-value pairs, and are merged together, with earlier values taking precedence.

The RELATIVE_SPECS_* values are added by face-remap-add-relative
(and removed by face-remap-remove-relative, and are intended for
face "modifications" (such as increasing the size). Typical users of relative specs would be minor modes.

BASE_SPECS is the lowest-priority value, and by default is just the face name, which causes the global definition of that face to be used.

A non-default value of BASE_SPECS may also be set using face-remap-set-base. Because this _overwrites_ the default value inheriting from the global face definition, it is up to the caller of face-remap-set-base to add such inheritance if it is desired. A typical use of face-remap-set-base would be a major mode setting face remappings, e.g., of the default face.

All modifications cause face-remapping-alist to be made buffer-local.

Defined variables (13)

buffer-face-modeNon-nil if Buffer-Face mode is enabled.
buffer-face-mode-faceThe face specification used by ‘buffer-face-mode’.
buffer-face-mode-hookHook run after entering or leaving ‘buffer-face-mode’.
global-text-scale-adjust-limitsMin/max values for ‘global-text-scale-adjust’.
global-text-scale-adjust-resizes-framesWhether ‘global-text-scale-adjust’ resizes the frames.
text-scale--pinch-start-scaleThe text scale at the start of a pinch sequence.
text-scale-modeNon-nil if Text-Scale mode is enabled.
text-scale-mode-amountNumber of steps that ‘text-scale-mode’ will increase/decrease text height.
text-scale-mode-hookHook run after entering or leaving ‘text-scale-mode’.
text-scale-mode-lighterLighter displayed for ‘text-scale-mode’ in mode-line minor-mode list.
text-scale-mode-remappingCurrent remapping cookie for ‘text-scale-mode’.
text-scale-mode-stepScale factor used by ‘text-scale-mode’.
text-scale-remap-header-lineIf non-nil, text scaling may change font size of header lines too.

Defined functions (23)

buffer-face-mode(&optional ARG)
buffer-face-mode-invoke(SPECS ARG &optional INTERACTIVE)
buffer-face-set(&rest SPECS)
buffer-face-toggle(&rest SPECS)
face-attrs--make-indirect-safe()
face-attrs-more-relative-p(ATTRS1 ATTRS2)
face-remap--remap-face(SYM)
face-remap-add-relative(FACE &rest SPECS)
face-remap-order(ENTRY)
face-remap-remove-relative(COOKIE)
face-remap-reset-base(FACE)
face-remap-set-base(FACE &rest SPECS)
global-text-scale-adjust(INCREMENT)
text-scale--refresh(SYMBOL NEWVAL OPERATION WHERE)
text-scale-adjust(INC)
text-scale-decrease(DEC)
text-scale-increase(INC)
text-scale-max-amount()
text-scale-min-amount()
text-scale-mode(&optional ARG)
text-scale-pinch(EVENT)
text-scale-set(LEVEL)
variable-pitch-mode(&optional ARG)

Defined faces (0)