diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index 3fd54cb147f..0ea421c774b 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -3197,10 +3197,10 @@ and @code{face-remap-reset-base} functions; it is intended for major modes to remap faces in the buffers they control. @defun face-remap-add-relative face &rest specs -This function adds the face spec in @var{specs} as relative -remappings for face @var{face} in the current buffer. The remaining -arguments, @var{specs}, should form either a list of face names, or a -property list of attribute/value pairs. +This function adds @var{specs} as relative remappings for face +@var{face} in the current buffer. @var{specs} should be a list where +each element is either a face name, or a property list of +attribute/value pairs. The return value is a Lisp object that serves as a cookie; you can pass this object as an argument to @code{face-remap-remove-relative}