Subject: Re: bug#45264: 26.3; `face-remap-set-base' seems to be bugged

From: Eli Zaretskii <[email-masked]>
Date: Sat, 19 Dec 2020 21:40:06 +0200

> Date: Sat, 19 Dec 2020 11:28:31 -0800 (PST)
> From: Drew Adams <[email-masked]>
> Cc: [email-masked]
> 
> > > The confusion is from the doc not saying explicitly
> > > that each element of SPECS is a face spec, and NOT a
> > > face.
> > 
> > SPECS has no "elements".  SPECS stands for arguments to the function
> > beyond the 1st arg FACE.
> 
> As with any &rest, you supply zero or more actual
> args that correspond to SPECS.  The function itself
> receives a single list argument that corresponds to
> SPECS.
> 
> In the function body, variable SPECS is a list.
> And as the doc says, "Each list element...".

The doc string shouldn't explain how the function's body sees SPECS,
it should explain how to provide those args.

> Please check for the behavior bug I pointed to:

If it doesn't work according to the doc string, then yes, it's a bug.