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.

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

_E_x_a_m_p_l_e_s:

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

