[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#69935: [PATCH] (help-fns-function-description-header): Print functio
From: |
Eli Zaretskii |
Subject: |
bug#69935: [PATCH] (help-fns-function-description-header): Print functions' type |
Date: |
Fri, 22 Mar 2024 09:25:58 +0200 |
> Date: Thu, 21 Mar 2024 21:22:39 -0400
> From: Stefan Monnier via "Bug reports for GNU Emacs,
> the Swiss army knife of text editors" <bug-gnu-emacs@gnu.org>
>
> The patch below changes the first line of `C-h f` from something like:
>
> car is a built-in function in ‘C source code’.
>
> to
>
> car is a primitive-function in ‘C source code’.
>
> i.e. print the actual type rather than an English description.
> The type is buttonized so users can click on it to see a description of
> the type (and its super/subtypes).
>
> Beside exposing those types (and their related information), another
> advantage is that it simplifies the code since we don't need to
> enumerate all the different kinds of functions we may have (well, we
> still do for those "function-like objects" which don't have a dedicated
> type such as macros, keymaps, aliases, keyboard macros, yadda yadda, but
> a single case covers all of special forms, primitive functions,
> byte-code functions, module functions, and native-compiled functions).
>
> Any comment/objection?
No objections, but IMO this should be in NEWS, and the button and
its purpose should be described in the user manual (where we document
"C-h f").
Thanks.