Re: Poor quality documentation in edebug.el, and recursive documentation.

[Eli Zaretskii]

On May 12, 2020 9:33:49 AM GMT+03:00, Madhu <address@hidden> wrote:
> * Stefan Monnier <address@hidden> :
> Wrote on Fri, 08 May 2020 16:24:28 -0400:
> 
> >> where I was at the beginning of the week.  I don't know what a
> >> "metaclass" is,
> >
> > It's a generic term from the OO crowd.  It's class of a class: in
> > languages where classes can be manipulated as normal objects, they
> > themselves belong to a class, called the metaclass (which is hence
> > itself a class with its own metaclass, etc...).
> >
> > Luckily you shouldn't need to know any of those things unless you
> need
> > to dig into the implementation of Elisp's OO facilities such as
> > `cl-defstruct`, `eieio`, or `cl-generic`, basically.
> 
> Unfortunately we need to know because we have to deal with your
> misdesign of those features and language constructs.

[More toxic language elided.]

Please tone down your messages.  Regardless of whether one agrees with your 
technical arguments (I don't, FTR), the tone and toxic accusations are 
unacceptable.  Please be sure not to accuse anyone here of being incompetent, 
and Stefan less than anyone else.