getPkgVigList             package:DynDoc             R Documentation

_A _f_u_n_c_t_i_o_n _t_o _r_e_t_r_i_e_v_e _a _l_i_s_t_i_n_g _o_f _p_a_c_k_a_g_e _v_i_g_n_e_t_t_e_s

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

     Functionality to retrive vignette metadata, on a per-vignette or a
     per-package level.

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

     getPkgVigList(pkg, vigDescFun=baseVigDesc, vigPath = "/doc/", 
     vigExt="\.(Rnw|Snw|rnw|snw|Rtex)$", pkgVers = TRUE)

     getVigInfo(vig,pkg=NULL, vigDescFun=baseVigDesc, pkgVers=TRUE)

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

     pkg: Path to a package directory

     vig: Filename of a vignette

vigDescFun: Function to provide output string for display

 vigPath: Path to directory that contains vignettes in the package

  vigExt: Regular expression pattern to match vignette file extensions

 pkgVers: Record the package version with the other vignette metadata

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

     getPkgVigList: This function will look at all vignette files in
     the directory '<pkg>/<vigPath>'.  It will then extract any header
     information (using 'getVigInfo'), and return a list of this
     information.

     getVigInfo:  This function will retrieve the metadata from a
     particular vignette file.  Any line starting with '%\Vignette' is
     taken to be metadata.  Common values include VignetteIndexEntry
     (required), VignetteKeywords, VignetteDepends, etc.  A named list
     of lists is returned to the user, where the names correspond to
     the particular metadata variable.

     Both functions take a parameter 'baseVigDesc', which is a function
     to provide the output string to correspond with a vignette
     summary.  This function is directly called by 'getVigInfo'.  It
     takes one parameter, which is a vigInfo list from 'getVigInfo'.

_A_u_t_h_o_r(_s):

     Jeff Gentry

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

     'vignette'

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

     ## Not run: 
        ## We need a vignette for this to work
        dynPath <- .path.package("DynDoc")
        vigList <- getPkgVigList(dynPath)
        vigList
     ## End(Not run)

