GNU bug report logs - #29462
24.4; eval-when-compile won't mute warning as says in info doc

Previous Next

Full log

Message #19 received at 29462 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Michael Heerdegen <michael_heerdegen <at> web.de>
Cc: 29462 <at> debbugs.gnu.org
Subject: Re: bug#29462: 24.4;
 eval-when-compile won't mute warning as says in info doc
Date: Mon, 27 Nov 2017 18:29:25 +0200

> From: Michael Heerdegen <michael_heerdegen <at> web.de>
> Date: Mon, 27 Nov 2017 03:44:46 +0100
> 
> Emanuel Berg <moasen <at> zoho.com> writes:
> 
> > In (info "(elisp) Warning Tips"), it says
> >
> >    * If you use many functions and variables
> >      from a certain file, you can add
> >      a ‘require’ for that package to avoid
> >      compilation warnings for them.
> >      For instance,
> >
> >           (eval-when-compile
> >             (require 'foo))
> 
> Thanks for the report.
> 
> I find this whole sentence confusing and misleading in general.  The
> main purpose of `require' is not to silence warnings, and calling it is
> very often something needed, not only something one "can" do.

The above citation is from a section which explains how to avoid
warnings.  It is not the place where we document 'require' itself,
only its use to avoid warnings.  So reading that out of context as a
statement of the main purpose of 'require' is a mistake, as 'require'
is fully documented elsewhere in the manual.

In the context of avoiding warnings, I see no problem in mentioning
'require'.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.