packageStatus             package:utils             R Documentation

_P_a_c_k_a_g_e _M_a_n_a_g_e_m_e_n_t _T_o_o_l_s

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

     Summarize information about installed packages and packages
     available at various repositories, and automatically upgrade
     outdated packages. These tools will replace 'update.packages' and
     friends in the future and are currently work in progress.

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

     packageStatus(lib.loc = NULL,
                   repositories = getOption("repositories")())

     ## S3 method for class 'packageStatus':
     summary(object, ...)

     ## S3 method for class 'packageStatus':
     update(object, lib.loc = levels(object$inst$LibPath),
            repositories = levels(object$avail$Repository), ...)

     ## S3 method for class 'packageStatus':
     upgrade(object, ask = TRUE, ...)

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

 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.

repositories: a character vector of URLs describing the location of R
          package repositories on the Internet or on the local machine.

  object: an object of class '"packageStatus"' as returned by
          'packageStatus'.

     ask: if 'TRUE', the user is prompted which packages should be
          upgraded and which not.

     ...: currently not used.

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

     There are 'print' and 'summary' methods for the '"packageStatus"'
     objects: the 'print' method gives a brief tabular summary and the
     'summary' method prints the results.

     The 'update' method updates the '"packageStatus"' object. The
     'upgrade' method is similar to 'update.packages': it offers to
     install the current versions of those packages which are not
     currently up-to-date.

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

     An object of class '"packageStatus"'.  This is a list with two
     components

    inst: a data frame with columns '"Package"', '"Version"',
          '"Priority"', '"Bundle"', '"Depends"', '"Built"', '"Status"'
          and '"LibPath"'. 

   avail: a data frame  with columns '"Package"', '"Version"',
          '"Priority"', '"Bundle"', '"Depends"', '"Built"', '"Status"'
          and '"Repository"' (the URL of the directory from which they
          can be fetched). 


     These have similar content to the _matrices_ returned by
     'installed.packages' and 'CRAN.packages'.

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

     ## Not run: 
     x <- packageStatus()
     print(x)
     summary(x)
     upgrade(x)
     x <- update(x)
     print(x)
     ## End(Not run)

