bug#15714: 24.3.50; Confusing documentation of face attributes

bug#15714: 24.3.50; Confusing documentation of face attributes

[Xue Fuqiao]

(You can also see
http://lists.gnu.org/archive/html/help-gnu-emacs/2013-10/msg00428.html)

(face-all-attributes 'default)
  =>
((:family . unspecified) (:foundry . unspecified) (:width .
specified) (:height . unspecified) (:weight . unspecified) (:slant .
specified) (:underline . unspecified) (:overline . unspecified)
strike-through . unspecified) (:box . unspecified) (:inverse-video .
specified) (:foreground . unspecified) ...)

But in (info "(elisp) Face Attributes"):

  An ‘unspecified’ attribute tells Emacs to refer instead to a parent
  face; or, failing that, to an underlying face.  The ‘default’ face
  must specify all attributes.

Unexpectedly, all the attributes returned by face-all-attributes are
‘unspecified’, so it may be a documentation bug.

In GNU Emacs 24.3.50.1 (x86_64-unknown-linux-gnu, GTK+ Version 3.8.4)
 of 2013-10-19 on xfq-Inspiron-5437
Bzr revision: 114713 xfq.free@gmail.com-20131018142744-tcr7cpncn90zuns1

Important settings:
  value of $LC_MONETARY: en_US.UTF-8
  value of $LC_NUMERIC: en_US.UTF-8
  value of $LC_TIME: en_US.UTF-8
  value of $LANG: en_US.UTF-8
  value of $XMODIFIERS: @im=ibus
  locale-coding-system: utf-8-unix
  default enable-multibyte-characters: t

-- 
Best regards, Xue Fuqiao.
http://www.gnu.org/software/emacs/

bug#15714: 24.3.50; Confusing documentation of face attributes

[Glenn Morris]

Xue Fuqiao wrote:

> (face-all-attributes 'default)

Cf

 (face-all-attributes 'default (selected-frame))

bug#15714: 24.3.50; Confusing documentation of face attributes

[Lars Ingebrigtsen]

Glenn Morris <rgm@gnu.org> writes:

> Xue Fuqiao wrote:
>
>> (face-all-attributes 'default)
>
> Cf
>
>  (face-all-attributes 'default (selected-frame))

I don't think there's anything to fix here, so I'm closing this bug report.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no