Re: define issues

[Eli Zaretskii]

> Date: Mon, 16 Mar 2009 16:47:16 -0700
> From: Philip Guenther <address@hidden>
> Cc: address@hidden
> 
> To be blunt, $(eval) should be relegated to the "EXPERTS ONLY" section
> of the manual...and if you don't understand what I meant by "before vs
> during vs afterwards", then you're not an expert and should not use
> it.
> [...]
> Similarly, I suggest to the GNU make maintainers to think *real hard*
> about what they can do to ease the support burden that has been
> created by $(eval) being freely used by people that think it simpler
> than it is, perhaps starting with a pile of warnings and cookbook
> examples in the info pages...but I'll leave that to someone who
> actually likes $(eval).

Maybe we should just improve the documentation to better explain what
$(eval) does and how, so that even non-experts will see the light.
What is missing from the current docs that you think should be there
(and I don't mean the warning to stay away)?