Re: elisp's cl package. Don't understand the notice about eval-when-compile

[Thomas F. Burdick]

On Mar 25, 4:02 am, Xah Lee <xah...@gmail.com> wrote:
> in emacs lisp's CL package documentation “(info "(cl)Overview")”, it
> has this passage:
>
>    *Please note:* the "CL" functions are not standard parts of the
> Emacs Lisp name space, so it is legitimate for users to define them
> with other, conflicting meanings.  To avoid conflicting with those
> user
> activities, we have a policy that packages installed in Emacs must not
> load "CL" at run time.  (It is ok for them to load "CL" at compile
> time
> only, with `eval-when-compile', and use the macros it provides.)  If
> you are writing packages that you plan to distribute and invite
> widespread use for, you might want to observe the same rule.
>
> I don't quite understand it.
>
> If i distribute a package xyz.el, which calls
>
> (eval-when-compile (require 'cl))
>
> And, this package does not require users to byte-compile it. Then,
> how's the eval-when-compile solve the name conflict problem?
>
> does it imply that if you distribute a package using cl, it must be
> byte compiled eventually?

No. It's saying that if you are trying to get your package included in
the official Emacs distribution, you can only use macros from cl.el,
not functions.