]> git.eshelyaron.com Git - emacs.git/commitdiff
Fix ELisp "Warning Tips"
authorEli Zaretskii <eliz@gnu.org>
Mon, 27 Nov 2017 16:24:29 +0000 (18:24 +0200)
committerEli Zaretskii <eliz@gnu.org>
Mon, 27 Nov 2017 16:24:29 +0000 (18:24 +0200)
* doc/lispref/tips.texi (Warning Tips): Clarify when to use
'require' wrapped by 'eval-when-compile'.  (Bug#29462)

doc/lispref/tips.texi

index 17fd4a1027e4592f7a7fe6431245d050509ec486..42a68677f585a281c1b6211c95cf7f1029e68c69 100644 (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