Fix ELisp "Warning Tips"

* doc/lispref/tips.texi (Warning Tips): Clarify when to use
'require' wrapped by 'eval-when-compile'.  (Bug#29462)
This commit is contained in:
Eli Zaretskii 2017-11-27 18:24:29 +02:00
parent 06d05fec84
commit 0a85d12474

View file

@ -534,9 +534,17 @@ that you know @emph{will} be defined, use a @code{declare-function}
statement (@pxref{Declaring Functions}).
@item
If you use many functions and variables from a certain file, you can
add a @code{require} for that package to avoid compilation warnings
for them. For instance,
If you use many functions, macros, and variables from a certain file,
you can add a @code{require} (@pxref{Named Features, require}) for
that package to avoid compilation warnings for them, like this:
@example
(require 'foo)
@end example
@noindent
If you need only macros from some file, you can require it only at
compile time (@pxref{Eval During Compile}). For instance,
@example
(eval-when-compile