The R Project SVN R

Rev

Rev 59039 | Rev 69952 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 59039 Rev 62077
Line 1... Line 1...
1 
% File src/library/base/man/find.package.Rd
 1 
% File src/library/base/man/find.package.Rd
2 
% Part of the R package, http://www.R-project.org
 2 
% Part of the R package, http://www.R-project.org
3 
% Copyright 1995-2011 R Core Team
 3 
% Copyright 1995-2013 R Core Team
4 
% Distributed under GPL 2 or later
 4 
% Distributed under GPL 2 or later
5 
 
 5 
 
6 
\name{find.package}
 6 
\name{find.package}
7 
 
 7 
 
8 
\alias{find.package}
 8 
\alias{find.package}
9 
\alias{path.package}
 9 
\alias{path.package}
10 
%% moved from base-internal.Rd in 2.13.1
 - 
 
11 
\alias{.find.package}
 - 
 
12 
\alias{.path.package}
 - 
 
13 
 
 10 
 
14 
\title{Find Packages}
 11 
\title{Find Packages}
15 
\description{
 12 
\description{
16 
  Find the paths to one or more packages.
 13 
  Find the paths to one or more packages.
17 
}
 14 
}
Line 23... Line 20...
23 
}
 20 
}
24 
\arguments{
 21 
\arguments{
25 
  \item{package}{character vector: the names of packages.}
 22 
  \item{package}{character vector: the names of packages.}
26 
  \item{lib.loc}{a character vector describing the location of \R
 23 
  \item{lib.loc}{a character vector describing the location of \R
27 
    library trees to search through, or \code{NULL}.  The default value
 24 
    library trees to search through, or \code{NULL}.  The default value
28 
    of \code{NULL} corresponds to checking the attached packages, then
 25 
    of \code{NULL} corresponds to checking the loaded namespace, then
29 
    all libraries currently known in \code{\link{.libPaths}()}.}
 26 
    all libraries currently known in \code{\link{.libPaths}()}.}
30 
  \item{quiet}{logical.  Should this not give warnings or an error
 27 
  \item{quiet}{logical.  Should this not give warnings or an error
31 
    if the package is not found?}
 28 
    if the package is not found?}
32 
  \item{verbose}{a logical.  If \code{TRUE}, additional diagnostics are
 29 
  \item{verbose}{a logical.  If \code{TRUE}, additional diagnostics are
33 
    printed.}
 30 
    printed.}
34 
}
 31 
}
35 
\details{
 32 
\details{
36 
  \code{find.package} returns path to the locations where the
 33 
  \code{find.package} returns path to the locations where the
37 
  given packages are found.  If \code{lib.loc} is \code{NULL}, then
 34 
  given packages are found.  If \code{lib.loc} is \code{NULL}, then
38 
  attached packages are searched before the libraries.  If a package is
 35 
  loaded namespaces are searched before the libraries.  If a package is
39 
  found more than once, the first match is used.  Unless \code{quiet =
 36 
  found more than once, the first match is used.  Unless \code{quiet =
40 
  TRUE} a warning will be given about the named packages which are not
 37 
  TRUE} a warning will be given about the named packages which are not
41 
  found, and an error if none are.  If \code{verbose} is true, warnings
 38 
  found, and an error if none are.  If \code{verbose} is true, warnings
42 
  about packages found more than once are given.  For a package to be
 39 
  about packages found more than once are given.  For a package to be
43 
  returned it must contain a either a \file{Meta} subdirectory or a
 40 
  returned it must contain a either a \file{Meta} subdirectory or a
Line 58... Line 55...
58 
  are not attached, and given an error if none are.
 55 
  are not attached, and given an error if none are.
59 
}
 56 
}
60 
\value{
 57 
\value{
61 
  A character vector of paths of package directories.
 58 
  A character vector of paths of package directories.
62 
}
 59 
}
63 
\note{
 - 
 
64 
  \code{.find.package} and \code{.path.package} were internal-only
 - 
 
65 
  versions prior to \R 2.13.0, and are now wrappers for these public
 - 
 
66 
  versions.
 - 
 
67 
}
 - 
 
68 
\keyword{files}
 60 
\keyword{files}