eintr: Interactive
3.3 Make a Function Interactive
===============================
You make a function interactive by placing a list that begins with the
special form ‘interactive’ immediately after the documentation. A user
can invoke an interactive function by typing ‘M-x’ and then the name of
the function; or by typing the keys to which it is bound, for example,
by typing ‘C-n’ for ‘next-line’ or ‘C-x h’ for ‘mark-whole-buffer’.
Interestingly, when you call an interactive function interactively,
the value returned is not automatically displayed in the echo area.
This is because you often call an interactive function for its side
effects, such as moving forward by a word or line, and not for the value
returned. If the returned value were displayed in the echo area each
time you typed a key, it would be very distracting.
Menu