undoc                 package:tools                 R Documentation

_F_i_n_d _U_n_d_o_c_u_m_e_n_t_e_d _O_b_j_e_c_t_s

_D_e_s_c_r_i_p_t_i_o_n:

     Finds the objects in a package which are undocumented, in the
     sense that they are visible to the user (or data objects or S4
     classes provided by the package), but no documentation entry
     exists.

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

     undoc(package, dir, lib.loc = NULL)

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

 package: a character string naming an installed package.

     dir: a character string specifying the path to a package's root
          source directory.  This must contain the subdirectory 'man'
          with R documentation sources (in Rd format), and at least one
          of the 'R' or 'data' subdirectories with R code or data
          objects, respectively.

 lib.loc: a character vector of directory names of R libraries, or
          'NULL'.  The default value of 'NULL' corresponds to all
          libraries currently known.  The specified library trees are
          used to to search for 'package'.

_D_e_t_a_i_l_s:

     This function is useful for package maintainers mostly.  In
     principle, _all_ user level R objects should be documented; note
     however that the precise rules for documenting methods of generic
     functions are still under discussion.

     The 'base' package is special as it contains the primitives and
     these do not have definitions available at code level.  We provide
     equivalent closures in environments '.ArgsEnv' and
     '.GenericArgsEnv' in the 'base' package that are used for various
     purposes: 'undoc("base")' checks that that all the primitive that
     are not language constructs are prototyped in those environments
     and no others.

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

     An object of class '"undoc"' which is a list of character vectors
     containing the names of the undocumented objects split according
     to documentation type.  This representation is still experimental,
     and might change in future versions.

     There is a 'print' method for nicely displaying the information
     contained in such objects.

_S_e_e _A_l_s_o:

     'codoc', 'QC'

_E_x_a_m_p_l_e_s:

     undoc("tools")                  # Undocumented objects in 'tools'

