Re: master af0ea35ea0: Tweak how functions are formatted in Implementation in *Help*

[Lars Ingebrigtsen]

Stefan Monnier <monnier@iro.umontreal.ca> writes:

>> I don't think it's more confusing than before, though.  :-/
>
> Before your recent changes it was:
>
>     [...]
>
>     ((SPECIALIZER (head derived-mode))) in ‘cl-generic.el’.
>
>     Support for (derived-mode MODE) specializers.
>     Used internally for the (major-mode MODE) context specializers.
>
>     :extra "typeof" (TYPE) in ‘cl-generic.el’.

And I found that very confusing -- I didn't really know what it was
trying to express before this bug report.

> Maybe a way to solve the problem is to use something like:
>
>     [...]
>
>     (cl-generic-generalizers (SPECIALIZER (head derived-mode))) in
> ‘cl-generic.el’.
>
>     Support for (derived-mode MODE) specializers.
>     Used internally for the (major-mode MODE) context specializers.
>
>     (cl-generic-generalizers TYPE) in ‘cl-generic.el’.
>     :extra "typeof"

I still don't understand what the :extra "typeof" is trying to tell me.
:-) 

> Of course the `cl-generic-generalizers` is always redundant and risks
> pushing the line length past the window width, which was some of the
> reasons why I originally used just:

We could format this better, yes.

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