Function: set-face-underline

set-face-underline is an interactive and byte-compiled function defined in faces.el.gz.

Signature

(set-face-underline FACE UNDERLINE &optional FRAME)

Documentation

Specify whether face FACE is underlined.

UNDERLINE nil means FACE explicitly doesn't underline. UNDERLINE t means FACE underlines with its foreground color. If UNDERLINE is a string, underline with that color.

UNDERLINE may also be a list of the form (:color COLOR :style STYLE), where COLOR is a string or foreground-color, and STYLE is either line or wave. :color may be omitted, which means to use the foreground color. :style may be omitted, which means to use a line.

FRAME nil or not specified means change face on all frames. Use set-face-attribute to "unspecify" underlining.

View in manual

Key Bindings

Source Code

;; Defined in /usr/src/emacs/lisp/faces.el.gz
(defun set-face-underline (face underline &optional frame)
  "Specify whether face FACE is underlined.
UNDERLINE nil means FACE explicitly doesn't underline.
UNDERLINE t means FACE underlines with its foreground color.
If UNDERLINE is a string, underline with that color.

UNDERLINE may also be a list of the form (:color COLOR :style STYLE),
where COLOR is a string or `foreground-color', and STYLE is either
`line' or `wave'.  :color may be omitted, which means to use the
foreground color.  :style may be omitted, which means to use a line.

FRAME nil or not specified means change face on all frames.
Use `set-face-attribute' to \"unspecify\" underlining."
  (interactive (read-face-and-attribute :underline))
  (set-face-attribute face frame :underline underline))