bug#11225: 24.1.50; Explanation of SPECS arg in docstrings in face-remap.el insufficient

[Chong Yidong]

Michael Heerdegen <michael_heerdegen@web.de> writes:

> there are commands in face-remap.el that take a "specs" argument
> (`face-remap-add-relative', `face-remap-set-base').  Their doc tells
> that SPECS can also be a list of faces.  It doesn't explain what the
> meaning of a list of faces for that functions is.
>
> Also the manual doesn't explain it (Node "Face Remapping").
>
> Maybe the docstrings and the manual can be clarified by adding just
> one or two sentences that describe the meaning.

I've changed the manual and docstrings to clarify this.  Thanks.