promptMethods            package:methods            R Documentation

_G_e_n_e_r_a_t_e _a _S_h_e_l_l _f_o_r _D_o_c_u_m_e_n_t_a_t_i_o_n _o_f _F_o_r_m_a_l _M_e_t_h_o_d_s

_D_e_s_c_r_i_p_t_i_o_n:

     Generates a shell of documentation for the methods of a generic
     function.

_U_s_a_g_e:

     promptMethods(f, filename = NULL, methods)

_A_r_g_u_m_e_n_t_s:

       f: a character string naming the generic function whose methods
          are to be documented.

filename: usually, a connection or a character string giving the name
          of the file to which the documentation shell should be
          written. The default corresponds to the coded topic name for
          these methods (currently, 'f' followed by '"-methods.Rd"'). 
          Can also be 'FALSE' or 'NA' (see below).

 methods: Optional methods list object giving the methods to be
          documented.  By default, the first methods object for this
          generic is used (for example, if the current global
          environment has some methods for 'f', these would be
          documented).

          If this argument is supplied, it is likely to be
          'getMethods(f, where)', with 'where' some package containing
          methods for 'f'.

_D_e_t_a_i_l_s:

     If 'filename' is 'FALSE', the text created is returned, presumably
     to be inserted some other documentation file, such as the
     documentation of the generic function itself (see 'prompt'). 

     If 'filename' is 'NA', a list-style representation of the
     documentation shell is created and returned.  Writing the shell to
     a file amounts to 'cat(unlist(x), file = filename, sep = "\n")',
     where 'x' is the list-style representation.

     Otherwise, the documentation shell is written to the file
     specified by 'filename'.

_V_a_l_u_e:

     If 'filename' is 'FALSE', the text generated; if 'filename' is
     'NA', a list-style representation of the documentation shell.
     Otherwise, the name of the file written to is returned invisibly.

_R_e_f_e_r_e_n_c_e_s:

     Chambers, John M. (2008) _Software for Data Analysis: Programming
     with R_ Springer.  (For the R version.)

     Chambers, John M. (1998) _Programming with Data_ Springer (For the
     original S4 version.)

_S_e_e _A_l_s_o:

     'prompt' and 'promptClass'

