unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#57064: describe-face accepts face_name as string
@ 2022-08-09  1:44 carlmarcos--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
  2022-08-09 18:30 ` Lars Ingebrigtsen
       [not found] ` <87k07huv51.fsf@gnus.org-N92sLte--B-2>
  0 siblings, 2 replies; 4+ messages in thread
From: carlmarcos--- via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2022-08-09  1:44 UTC (permalink / raw)
  To: 57064


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.





^ permalink raw reply	[flat|nested] 4+ messages in thread

* bug#57064: describe-face accepts face_name as string
  2022-08-09  1:44 bug#57064: describe-face accepts face_name as string carlmarcos--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
@ 2022-08-09 18:30 ` Lars Ingebrigtsen
       [not found] ` <87k07huv51.fsf@gnus.org-N92sLte--B-2>
  1 sibling, 0 replies; 4+ messages in thread
From: Lars Ingebrigtsen @ 2022-08-09 18:30 UTC (permalink / raw)
  To: carlmarcos; +Cc: 57064

carlmarcos@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.





^ permalink raw reply	[flat|nested] 4+ messages in thread

* bug#57064: describe-face accepts face_name as string
       [not found] ` <87k07huv51.fsf@gnus.org-N92sLte--B-2>
@ 2022-08-09 18:41   ` carlmarcos--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
  2022-08-11 20:52   ` carlmarcos--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
  1 sibling, 0 replies; 4+ messages in thread
From: carlmarcos--- via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2022-08-09 18:41 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 57064


Aug 9, 2022, 18:30 by larsi@gnus.org:

> carlmarcos@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?








^ permalink raw reply	[flat|nested] 4+ messages in thread

* bug#57064: describe-face accepts face_name as string
       [not found] ` <87k07huv51.fsf@gnus.org-N92sLte--B-2>
  2022-08-09 18:41   ` carlmarcos--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
@ 2022-08-11 20:52   ` carlmarcos--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
  1 sibling, 0 replies; 4+ messages in thread
From: carlmarcos--- via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2022-08-11 20:52 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 57064

Aug 9, 2022, 18:30 by larsi@gnus.org:

> carlmarcos@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?





^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2022-08-11 20:52 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-08-09  1:44 bug#57064: describe-face accepts face_name as string carlmarcos--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
2022-08-09 18:30 ` Lars Ingebrigtsen
     [not found] ` <87k07huv51.fsf@gnus.org-N92sLte--B-2>
2022-08-09 18:41   ` carlmarcos--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
2022-08-11 20:52   ` carlmarcos--- via Bug reports for GNU Emacs, the Swiss army knife of text editors

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).