RE: [External] : Re: master 2e9111813b: Add two classic Common Lisp macro-writing macros

[Drew Adams]

> > The purpose of the `cl-' prefix is so that we don't need to describe
> > those Common Lisp functions in the manual.  That is for functions
> > whose reason for existence in Emacs Lisp is compatibility.
> 
> That might have been the initial purpose, but there are already things
> with that prefix which are not only for compatibility.  For example,
> cl-letf, which isn't actually anywhere in CL but only in Elisp!

Yes, and FWIW, I (at least) complained about that
when it (and similar non-CL things) were added to
cl*.el.  I see (and got) no good reason for that.

> > When a function exists for other reasons, we should describe it
> > in the Emacs Lisp Reference Manual so that users can find it.
> > Giving it the`cl-' prefix is unnecessary and confusing.
> > Let's define it without a prefix.
> 
> If the functions were to be moved to subr-x, then they wouldn't get an
> entry in that manual, though.

Things that are not Common-Lisp emulation don't
belong in the cl*.el files, and they shouldn't
be documented in the CL manual.  IMHO.