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

