\Header{file.show}{Display One or More Files}
\keyword{file}{file.show}
\begin{Usage}
\begin{verbatim}
file.show(..., header, title="R Information",
          delete.file=FALSE, pager=options()$pager)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\texttt{...}] one or more character vectors containing the names of the
files to be displayed.
\item[\texttt{header}] vector (of the same length as the number of files
specified in \texttt{...}) giving a header for each file being
displayed. Defaults to empty strings.
\item[\texttt{title}] an overall title for the display.  If a separate window
is used for the display, \texttt{title} will be used as the
window title.
\item[\texttt{delete.file}] should the files be deleted after display? Used for
temporary files.
\item[\texttt{pager}] the pager to be used.
\end{ldescription}
\end{Arguments}
\begin{Description}
This function provides the core of the R help system,
but it can be used for other purposes as well.\end{Description}
\begin{Note}
How the pager is implemented is system dependent. At present
the Unix version concatentates files and displays them in the pager
set by the \texttt{pager} option setting. However, a GUI model might
be to put up a file in a separate
window and let the user leave it up while \R\ continues running.\end{Note}
\begin{Author}
Ross Ihaka, Brian Ripley.\end{Author}
\begin{SeeAlso}
\texttt{\Link{file}},
\texttt{\Link{list.files}},
\texttt{\Link{help}}.\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
file.show(paste(R.home(),
    "COPYRIGHTS", sep=.Platform$file.sep))
\end{ExampleCode}
\end{Examples}

