page(x, pager=options()$pager, filename, window=F,
display=getenv("DISPLAY"), title=<<see below>>,
remove.file=F)
x is omitted,
filename is required.
pager argument is omitted, the S-PLUS
pager option is used (i.e.,
options("pager")).
That option has a default value of
less.
filename is given and
x is not, the file will be displayed in the pager. If
filename is omitted,
x is required.
TRUE,
x or
filename is paged in its own window. This option is currently implemented only for X11-based window systems. For it to work, either the
display argument must be specified or the environment variable DISPLAY must be set, and the window system must be running. By default,
window=FALSE.
window must be
TRUE for this to have any effect. If
window=TRUE and
display is omitted, the DISPLAY environment variable is examined.
filename or
x. The argument
title is ignored if
window=FALSE.
TRUE,
filename is removed after
pager exits. This argument applies only when
filename is given and
x is not. By default,
remove.file=FALSE.
x or
filename is displayed under the control of
pager.
If
window=TRUE and all goes well, this occurs in a new window and
page returns immediately; the S-PLUS session can then continue independently of the paging window. If the window cannot be opened or if
window=FALSE, the object is printed in the current window or screen and the session can resume only after the pager has exited.
This function uses
, so it will wipe out a
sink that is in effect.
As with
print,
x may be any S-PLUS expression, not just object names. See the examples below for details.
The default S-PLUS pager is
less. For a summary of commands you can use with less, type
h in the less window.
The title on the new window will be wrong in obscure cases.
page(quakes.bay)
page(auto.stats[1:30,], window=T, title="Concord to St. Regis")
page(colMeans) # look at function in main window
page(colMeans(ethanol), window=T) # look at results in sep. window
page(get("%*%"), pager="view") # page(%*%) will not work
page(file=paste(getenv("SHOME"), "/library/README", sep=""))