file.show                package:base                R Documentation

_D_i_s_p_l_a_y _O_n_e _o_r _M_o_r_e _F_i_l_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     Display one or more files.

_U_s_a_g_e:

     file.show(..., header, title="R Information",
               delete.file=FALSE, pager=getOption("pager"))

_A_r_g_u_m_e_n_t_s:

     ...: one or more character vectors containing the names of the
          files to be displayed.

  header: character vector (of the same length as the number of files
          specified in `...') giving a header for each file being
          displayed.  Defaults to empty strings.

   title: an overall title for the display.  If a single separate
          window is used for the display, `title' will be used as the
          window title. If multiple windows are used, their titles
          should combine the title and the file-specific header.

delete.file: should the files be deleted after display?  Used for
          temporary files.

   pager: the pager to be used.

_D_e_t_a_i_l_s:

     This function provides the core of the R help system, but it can
     be used for other purposes as well.

_N_o_t_e:

     How the pager is implemented is highly system dependent.

     The basic Unix version concatenates the files (using the headers)
     to a temporary file, and displays it in the pager selected by the
     `pager' argument, which is a character vector specifying a system
     command to run on the set of files.

     Most GUI systems will use a separate pager window for each file,
     and let the user leave it up while R continues running.  The
     selection of such pagers could either be done using ``magic''
     pager names being intercepted by lower-level code (such as
     `"internal"' and `"console"' on Windows), or by letting `pager' be
     an R function which will be called with the same arguments as
     `file.show' and take care of interfacing to the GUI.

     Not all implementations will honour `delete.file'.

_A_u_t_h_o_r(_s):

     Ross Ihaka, Brian Ripley.

_S_e_e _A_l_s_o:

     `files', `list.files', `help'.

_E_x_a_m_p_l_e_s:

     file.show(file.path(R.home(), "COPYRIGHTS"))

