

edit {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 = "vi")
     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 ver-
          sion to.

  editor: a string naming the text editor you want to use.

_D_e_t_a_i_l_s_:

     `edit' invokes the text editor specified by `editor'
     with the object `name' to be edited.  `data.entry' can
     be used to edit data.  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 per-
     manent changes to an object.)

     In the form `edit(name)', `edit' deparses `name' into a
     temporary file and invokes the editor `editor' on this
     file. Quiting 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.

_S_e_e _A_l_s_o_:

     `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")

