bug#11059: 24.0.94; Please add `face-spec-set' to the elisp manual

[Chong Yidong]

Michael Heerdegen <michael_heerdegen@web.de> writes:

> I know that I _can_ use `custom-set-faces' explicitly in .emacs for this
> purpose - that works.  But is this really the right function for users
> to use in their .emacs to redefine faces?

If you want your changes to play nicely with the Custom interface, you
should use `custom-set-faces'.

Obviously, code in .emacs is allowed to do anything.  So for example if
you really don't want to use `custom-set-faces', you could set the
`face-defface-spec' symbol property directly.  But this will cause the
original spec to be lost, and also you have to make sure that the face
has already been defined with defface, i.e. it's listed in
`face-new-frame-defaults' etc.

> If yes, the manual section "Faces" should at least mention it.

I'll see what I can do.