promptClass             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 _a _F_o_r_m_a_l _C_l_a_s_s

_D_e_s_c_r_i_p_t_i_o_n:

     Assembles all relevant slot and method information for a class,
     with minimal markup for Rd processing; no QC facilities at
     present.

_U_s_a_g_e:

     promptClass(clName, filename = NULL, type = "class",
                 keywords = "classes", where = topenv(parent.frame()))

_A_r_g_u_m_e_n_t_s:

  clName: a character string naming the class 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 a file whose name is the
          topic name for the class documentation, followed by '".Rd"'. 
          Can also be 'NA' (see below).

    type: the documentation type to be declared in the output file.

keywords: the keywords to include in the shell of the documentation. 
          The keyword '"classes"' should be one of them.

   where: where to look for the definition of the class and of methods
          that use it. 

_D_e_t_a_i_l_s:

     The class definition is found on the search list.  Using that
     definition, information about classes extended and slots is
     determined.

     In addition, the currently available generics with methods for
     this class are found (using 'getGenerics').  Note that these
     methods need not be in the same environment as the class
     definition; in particular, this part of the output may depend on
     which packages are currently in the search list.

     As with other prompt-style functions, unless 'filename' is 'NA',
     the documentation shell is written to a file, and a message about
     this is given.  The file will need editing to give information
     about the _meaning_ of the class.  The output of 'promptClass' can
     only contain information from the metadata about the formal
     definition and how it is used.

     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.

_V_a_l_u_e:

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

_A_u_t_h_o_r(_s):

     VJ Carey stvjc@channing.harvard.edu and John Chambers

_R_e_f_e_r_e_n_c_e_s:

     The web page <URL: http://www.omegahat.org/RSMethods/index.html>
     is the primary documentation.

     The functions in this package emulate the facility for classes and
     methods described in _Programming with Data_ (John M. Chambers,
     Springer, 1998).  See this book for further details and examples.

_S_e_e _A_l_s_o:

     'prompt' for documentation of functions, 'promptMethods' for
     documentation of method definitions.

     For processing of the edited documentation, either use 'R CMD
     Rdconv', or include the edited file in the 'man' subdirectory of a
     package.

_E_x_a_m_p_l_e_s:

     ## Not run: 
     > promptClass("track")
     A shell of class documentation has been written to the
     file "track-class.Rd".
     ## End(Not run)

