promptPackage             package:utils             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 _P_a_c_k_a_g_e

_D_e_s_c_r_i_p_t_i_o_n:

     Generates a shell of documentation for an installed or source
     package.

_U_s_a_g_e:

     promptPackage(package, lib.loc = NULL, filename = NULL,
                   name = NULL, final = FALSE)

_A_r_g_u_m_e_n_t_s:

 package: the name of an _installed_ or _source_ package to be
          documented.

 lib.loc: a character vector describing the location of R library trees
          to search through, or 'NULL'.  The default value of 'NULL'
          corresponds to all libraries currently known.  For a source
          package this should specify the parent directory of the
          package's sources.

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
          'name' followed by '".Rd"'.  Can also be 'NA' (see below).

    name: a character string specifying the name of the help topic,
          typically of the form '<pkg>-package'.

   final: a logical value indicating whether to attempt to create a
          usable version of the help topic, rather than just a shell.

_D_e_t_a_i_l_s:

     Unless 'filename' is 'NA', a documentation shell for 'package' is
     written to the file specified by 'filename', and a message about
     this is given.  

     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.

     If 'final' is 'TRUE', the generated documentation will not include
     the place-holder slots for manual editing, it will be usable
     as-is.  In most cases a manually edited file is preferable (but
     'final = TRUE' is certainly less work).

_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.

_S_e_e _A_l_s_o:

     'prompt'

_E_x_a_m_p_l_e_s:

     filename <- tempfile()
     promptPackage("utils", file=filename)
     file.show(filename)
     unlink(filename)

