GNU bug report logs - #57064
describe-face accepts face_name as string

Previous Next

Package: emacs;

Reported by: carlmarcos <at> tutanota.com

Date: Tue, 9 Aug 2022 01:45:02 UTC

Severity: normal

Tags: notabug

Done: Lars Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 57064 in the body.
You can then email your comments to 57064 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#57064; Package emacs. (Tue, 09 Aug 2022 01:45:02 GMT) Full text and rfc822 format available.
Acknowledgement sent to carlmarcos <at> tutanota.com:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Tue, 09 Aug 2022 01:45:02 GMT) Full text and rfc822 format available.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: carlmarcos <at> tutanota.com
To: Bug Gnu Emacs <bug-gnu-emacs <at> gnu.org>
Subject: describe-face accepts face_name as string
Date: Tue, 9 Aug 2022 03:44:40 +0200 (CEST)

The documentation for function `describe-face' states that a FACE has to be passed

(describe-face FACE &optional FRAME)

But the code also calls this

(if (stringp f) (setq f (intern f)))

Meaning that users can pass tho face-name as a string, but this possibility is not mentioned in the documentation of the function.
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#57064; Package emacs. (Tue, 09 Aug 2022 18:31:01 GMT) Full text and rfc822 format available.

Message #8 received at 57064 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: carlmarcos <at> tutanota.com
Cc: 57064 <at> debbugs.gnu.org
Subject: Re: bug#57064: describe-face accepts face_name as string
Date: Tue, 09 Aug 2022 20:30:50 +0200

carlmarcos <at> tutanota.com writes:

> The documentation for function `describe-face' states that a FACE has
> to be passed
>
> (describe-face FACE &optional FRAME)
>
> But the code also calls this
>
> (if (stringp f) (setq f (intern f)))
>
> Meaning that users can pass tho face-name as a string, but this
> possibility is not mentioned in the documentation of the function.

We don't document things that we're not recommending people do.

Closing.
Added tag(s) notabug. Request was from Lars Ingebrigtsen <larsi <at> gnus.org> to control <at> debbugs.gnu.org. (Tue, 09 Aug 2022 18:32:02 GMT) Full text and rfc822 format available.
bug closed, send any further explanations to 57064 <at> debbugs.gnu.org and carlmarcos <at> tutanota.com Request was from Lars Ingebrigtsen <larsi <at> gnus.org> to control <at> debbugs.gnu.org. (Tue, 09 Aug 2022 18:32:02 GMT) Full text and rfc822 format available.
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#57064; Package emacs. (Tue, 09 Aug 2022 18:42:02 GMT) Full text and rfc822 format available.

Message #15 received at 57064 <at> debbugs.gnu.org (full text, mbox):

From: carlmarcos <at> tutanota.com
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 57064 <at> debbugs.gnu.org
Subject: Re: bug#57064: describe-face accepts face_name as string
Date: Tue, 9 Aug 2022 20:41:43 +0200 (CEST)

Aug 9, 2022, 18:30 by larsi <at> gnus.org:

> carlmarcos <at> tutanota.com writes:
>
>> The documentation for function `describe-face' states that a FACE has
>> to be passed
>>
>> (describe-face FACE &optional FRAME)
>>
>> But the code also calls this
>>
>> (if (stringp f) (setq f (intern f)))
>>
>> Meaning that users can pass tho face-name as a string, but this
>> possibility is not mentioned in the documentation of the function.
>>
>
> We don't document things that we're not recommending people do.
>
> Closing.
>
Why do you not want it used?  What's so wrong about it?
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#57064; Package emacs. (Thu, 11 Aug 2022 20:53:02 GMT) Full text and rfc822 format available.

Message #18 received at 57064 <at> debbugs.gnu.org (full text, mbox):

From: carlmarcos <at> tutanota.com
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 57064 <at> debbugs.gnu.org
Subject: Re: bug#57064: describe-face accepts face_name as string
Date: Thu, 11 Aug 2022 22:52:02 +0200 (CEST)

Aug 9, 2022, 18:30 by larsi <at> gnus.org:

> carlmarcos <at> tutanota.com writes:
>
>> The documentation for function `describe-face' states that a FACE has
>> to be passed
>>
>> (describe-face FACE &optional FRAME)
>>
>> But the code also calls this
>>
>> (if (stringp f) (setq f (intern f)))
>>
>> Meaning that users can pass tho face-name as a string, but this
>> possibility is not mentioned in the documentation of the function.
>>
>
> We don't document things that we're not recommending people do.
>
> Closing.
>
Why do you not recommend using the possibility exactly?
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Fri, 09 Sep 2022 11:24:07 GMT) Full text and rfc822 format available.
This bug report was last modified 2 years and 343 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.