Re: [PATCH] RFC: eldoc-documentation-functions hook

[Richard Stallman]

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

It is asking for trouble to have anything in the Emacs sources
put advice onto any function, because it interferes with debugging.
If you see a call to function foo, which has advice on it, you will be
perplexed why its behavior does not match its source.

(If you wrote the advice, you won't have this problem if you remember
that you put the advice on.)

A hook is cleaner, because the call to run-hooks in the source code of
foo informs you that you should check what hook functions there are.

Thus, I ask people to take care not to install anything in the Emacs
sources which creates advice -- and to replace any existing advice
with hooks.

-- 
Dr Richard Stallman
President, Free Software Foundation (gnu.org, fsf.org)
Internet Hall-of-Famer (internethalloffame.org)
Skype: No way! See stallman.org/skype.html.