edit                  package:base                  R Documentation

_I_n_v_o_k_e _a _T_e_x_t _E_d_i_t_o_r

_D_e_s_c_r_i_p_t_i_o_n:

     Invoke a text editor on an R object.

_U_s_a_g_e:

     edit(name = NULL, file = "", editor = getOption("editor"), ...)
     vi(name = NULL, file = "")
     emacs(name = NULL, file = "")
     pico(name = NULL, file = "")
     xemacs(name = NULL, file = "")
     xedit(name = NULL, file = "")

_A_r_g_u_m_e_n_t_s:

    name: a named object that you want to edit. If name is missing then
          the file specified by `file' is opened for editing.

    file: a string naming the file to write the edited version to.

  editor: a string naming the text editor you want to use.  On Unix the
          default is set from the environment variables `EDITOR' or
          `VISUAL' if either is set, otherwise `vi' is used.  On
          Windows it defaults to `notepad'.

     ...: further arguments to be passed to or from methods.

_D_e_t_a_i_l_s:

     `edit' invokes the text editor specified by `editor' with the
     object `name' to be edited.  It is a generic function, currently
     with a default method and one for data frames.

     `data.entry' can be used to edit data, and is used by `edit' to
     edit matrices and data frames on systems for which `data.entry' is
     available.

     It is important to realize that `edit' does not change the object
     called `name'. Instead, a copy of name is made and it is that copy
     which is changed. Should you want the changes to apply to the
     object `name' you must assign the result of `edit' to `name'. (Try
     `fix' if you want to make permanent changes to an object.)

     In the form `edit(name)', `edit' deparses `name' into a temporary
     file and invokes the editor `editor' on this file. Quitting from
     the editor causes `file' to be parsed and that value returned.
     Should an error occur in parsing, possibly due to incorrect
     syntax, no value is returned. Calling `edit()', with no arguments,
     will result in the temporary file being reopened for further
     editing.

_N_o_t_e:

     The functions `vi', `emacs', `pico', `xemacs', `xedit' rely on the
     corresponding editor being available and being on the path. This
     is system-dependent.

_S_e_e _A_l_s_o:

     `edit.data.frame', `data.entry', `fix'.

_E_x_a_m_p_l_e_s:

     # use xedit on the function mean and assign the changes
     mean <- edit(mean, editor = "xedit")

     # use vi on mean and write the result to file mean.out
     vi(mean, file = "mean.out")

