resolve.depends          package:reposTools          R Documentation

_A _f_u_n_c_t_i_o_n _t_o _c_h_e_c_k _f_o_r _d_e_p_e_n_d_e_n_c_y _b_r_e_a_k_a_g_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     Given a particular package, will check to insure that no
     dependencies are being broken if this package were to be changed
     (newer version installed, package removed, etc).

_U_s_a_g_e:

     resolve.depends(pkg, repEntry, force = FALSE, forward = TRUE, lib =
                      reposToolsLibPaths()[1], remove = FALSE, depends = TRUE,
                      suggests = TRUE, imports = TRUE, searchOptions = TRUE,
                      getAllDeps = FALSE, versForce = TRUE, method =
                      "auto", getNewest = FALSE, develOK=FALSE, curRepList=NULL)

_A_r_g_u_m_e_n_t_s:

     pkg: A pkgInfo object describing the package

repEntry: The 'ReposEntry' object the package is coming from

   force: Logical, if force==TRUE, will only 'warn' the user of
          dependencies, instead of 'stop'ing

 forward: Whether to check for and attempt to aquire any dependencies
          this package might have that are not already installed

     lib: Library that the original package is in

  remove: Logical to flag if the user is seeking to remove 'pkg'

 depends: Whether to 'stop' on unresolved 'depends' level dependencies

suggests: Whether to 'stop' on unresolved 'suggests' level dependencies

 imports: Whether to 'stop' on unresolved 'imports' level dependencies

searchOptions: Corresponds with the 'searchOptions' argument to
          'update.packages2' - used if downloading a package due to
          forward=TRUE

getAllDeps: Will automatically download all dependencies if TRUE,
          otherwise will prompt the user

versForce: Whether or not to override R version checking on binary
          packages

  method: What download method to use if any packages are downloaded
          and installed.  See the same parameter for
          'install.packages2'

getNewest: Passed down to any install.packages2() call internally

 develOK: If any packages are needed to be downloaded, if it is okay to
          get packages of 'devel' release level

curRepList: The current list of repositories being used by the
          installation functions, used to search for any dependencies.

_D_e_t_a_i_l_s:

     Will look for a local library listing file in every library
     specified by 'libs'.  If one exists, will check packages in that R
     library to see if the desired action would break any dependency
     links.  For instance, if package X depends on package Y version 2,
     and the user is looking to upgrade package Y to version 3 - or if
     the user wants to remove package Y altogether.

     By default, the system will 'stop' for any unresolved 'depends'
     and 'suggests' level dependencies, but only throw a 'warning' on
     any 'imports' level dependencies.  These can be toggled by the
     user.

     If 'force == TRUE', only 'warnings' will be given.

_A_u_t_h_o_r(_s):

     Jeff Gentry

_S_e_e _A_l_s_o:

     'pkgInfo','depends','syncLocalLibList'

_E_x_a_m_p_l_e_s: