prompt                 package:base                 R Documentation

_P_r_o_d_u_c_e _P_r_o_t_o_t_y_p_e _o_f _a_n _R _D_o_c_u_m_e_n_t_a_t_i_o_n _F_i_l_e

_D_e_s_c_r_i_p_t_i_o_n:

     Facilitate the constructing of files documenting R functions.

_U_s_a_g_e:

     prompt(object, ...)

     prompt.default(object,
         filename = paste(name, ".Rd", sep = ""),
         force.function = FALSE, ...)

     prompt.data.frame(object,
         filename = paste(name, ".Rd", sep = ""), ...)

_A_r_g_u_m_e_n_t_s:

  object: an R object, typically a function

filename: name of the output file

force.function: treat `object' as function in any case

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

_D_e_t_a_i_l_s:

     An ASCII file `filename' is produced containing the proper
     function and argument names of `object'.  You have to edit it
     before adding the documentation to the source tree, i.e.,
     (currently) to `$R_HOME/src/library/base/man/'.

_N_o_t_e:

     The documentation file produced by `prompt.data.frame' does not
     have the same format as many of the data frame documentation files
     in the `base' library.  We are trying to settle on a preferred
     format for the documentation.

_A_u_t_h_o_r(_s):

     Douglas Bates for `prompt.data.frame'

_S_e_e _A_l_s_o:

     `help' and the chapter on ``Writing R documentation'' in ``Writing
     R Extensions'' (see the `doc/manual' subdirectory of the R source
     tree).

_E_x_a_m_p_l_e_s:

     prompt(plot.default)
     prompt(interactive, force.function = TRUE)
     unlink("plot.default.Rd")
     unlink("interactive.Rd")

     data(women) # data.frame
     prompt(women)
     unlink("women.Rd")

     data(sunspots) # non-data.frame data
     prompt(sunspots)
     unlink("sunspots.Rd")

