[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: master af0ea35ea0: Tweak how functions are formatted in Implementati
From: |
Lars Ingebrigtsen |
Subject: |
Re: master af0ea35ea0: Tweak how functions are formatted in Implementation in *Help* |
Date: |
Sat, 02 Apr 2022 15:22:18 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) |
Stefan Monnier <monnier@iro.umontreal.ca> writes:
>> Is it worth applying `upcase' to the (nth 1 info) so the result looks
>> more like C-h f output?
>
> If so, we should be careful to only apply it to the argnames but not to
> the specializers since these are case sensitive.
Yup. But, yes, I think it would make sense to upcase/italicize the
argnames, because that would clarify what we're talking about here
(which isn't at all obvious). Patches welcome.
> The above patch also leads to odd results for methods with qualifiers.
> E.g. `C-h o cl-generic-generalizers RET` shows things like:
>
> :extra "cl-struct" (cl-generic-generalizers type) in ‘cl-generic.el’.
>
> Undocumented
>
> which I find rather confusing.
I've now made those things display as before, but I think it's not quite
clear what that part is trying to express, so some clarification here
would be nice.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
- Re: master af0ea35ea0: Tweak how functions are formatted in Implementation in *Help*,
Lars Ingebrigtsen <=