bug#24543: 25.1; describe-symbol doesn't show face with same name as a variable

[Alex]

Alex <agrambot@gmail.com> writes:

> Recipe:
>
> emacs -Q
> C-h o font-lock-comment-face RET
>
> Only the variable of this name is shown, not the face (which can be
> viewed with describe-face, of course).
>
> It appears that when the face only shares a name with a function, then
> both the function and face are shown. Only a variable shadows the face
> in describe-symbol.

This is because describe-symbol isn't returning (buffer-string) like
describe-{function, variable} are.

I've attached a patch fixing this problem.

Additionally, I have attached another patch that re-orders the placement
of variables/faces in describe-symbol, to put more emphasis on the
variable entry rather than the face.

0001-Properly-show-faces-in-describe-symbol-Bug-24543.patch
Description: fix

0002-lisp-help-mode.el-describe-symbol-backends-Reorder-e.patch
Description: reorder