comparison doc/lispref/help.texi @ 86051:8872c78278fa

(Help Functions): Document new macro `with-help-window'.

86050:b31897bf625c

This macro is used in the command @code{help-for-help} which is the
binding of @kbd{C-h C-h}.
@end defmac

@defopt three-step-help
If this variable is non-@code{nil}, commands defined with
@code{make-help-screen} display their @var{help-line} strings in the
echo area at first, and display the longer @var{help-text} strings only
if the user types the help character again.

86051:8872c78278fa

This macro is used in the command @code{help-for-help} which is the
binding of @kbd{C-h C-h}.
@end defmac

@defmac with-help-window buffer-name body@dots{}
This macro evaluates the @var{body} forms inserting any output they
produce into a buffer named @var{buffer-name}.  @code{with-help-window}
behaves like @code{with-output-to-temp-buffer} (@pxref{Temporary
Displays}) but does more accurately restore the previous window
configuration when quitting Help.  It also generates the message
informing the user how to quit and scroll the help window by itself.
Hence you will regret it if you use @code{print-help-return-message} in
the body of this macro.
@end defmac

@defopt three-step-help
If this variable is non-@code{nil}, commands defined with
@code{make-help-screen} display their @var{help-line} strings in the
echo area at first, and display the longer @var{help-text} strings only
if the user types the help character again.