\HeaderA{devAskNewPage}{Prompt before New Page}{devAskNewPage}
\keyword{dplot}{devAskNewPage}
\begin{Description}\relax
This function can be used to control (for the current device)
whether the user is prompted before starting a new page of output.
\end{Description}
\begin{Usage}
\begin{verbatim}
devAskNewPage(ask = NULL)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{ask}] \code{NULL} or a logical value.  If \code{TRUE}, the user
is prompted before a new page of output is started. 
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
If the current device is the null device, this will open a graphics device.

The default argument just returns the current setting and does not
change it.

The default value when a device is opened is taken from the
setting of \code{\LinkA{options}{options}("device.ask.default")}.

The precise circumstances when the user will be asked to confirm a new
page depend on the graphics subsystem.  Obviously this needs to be an
interactive session.  In addition \sQuote{recording} needs to be in
operation, so only when the display list is enabled (see
\code{\LinkA{dev.control}{dev.control}}) which it usually is only on a screen device.
\end{Details}
\begin{Value}
The current prompt setting \emph{before} any new setting is applied.
\end{Value}
\begin{SeeAlso}\relax
\code{\LinkA{plot.new}{plot.new}}, \code{\LinkA{grid.newpage}{grid.newpage}}
\end{SeeAlso}

