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 QA facilities at
     present.

_U_s_a_g_e:

     promptClass(clName, filename, type = "class", keywords = "classes", where)

_A_r_g_u_m_e_n_t_s:

  clName: character string naming the class to be documented. 

filename: Usually, the filename on which the documentation shell should
          be written.  By default it is the topic name for the class
          documentation, followed by ".Rd". See the example below.  The
          argument can also be any writable connection.

    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:  by default, anywhere in the current search
          list.  

_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, the documentation shell is
     written to a file, which 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.

_V_a_l_u_e:

     The name of the file to which the shell is written (the value is
     `invisible'). A message is also printed notifying the user about
     the file.

_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:

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

