The R Project SVN R

    \sQuote{Details} section).

    \sQuote{Details} section).

#endif

#endif

#ifdef unix

#ifdef unix

    \file{.tar.gz} files.  These can be source archives or binary

    \file{.tar.gz} files.  These can be source archives or binary

    package archive files (as created by \command{R CMD build --binary}).

    package archive files (as created by \command{R CMD build --binary}).

    containing binary package archives.

    containing binary package archives.

    Tilde-expansion will be done on the file paths.

    Tilde-expansion will be done on the file paths.

#endif

#endif

    If this is missing or a zero-length character vector, a listbox of

    If this is missing or a zero-length character vector, a listbox of

    Possible values are \code{"source"}, \code{"mac.binary.leopard"} and

    Possible values are \code{"source"}, \code{"mac.binary.leopard"} and

    \code{"win.binary"}: the binary types can be listed and downloaded

    \code{"win.binary"}: the binary types can be listed and downloaded

    but not installed on other platforms.

    but not installed on other platforms.

    The default is the appropriate binary type on Windows and on the

    The default is the appropriate binary type on Windows and on the

    the platforms where binary packages are the default, an alternative

    the platforms where binary packages are the default, an alternative

    is \code{"both"} which means \sQuote{try binary if available,

    is \code{"both"} which means \sQuote{try binary if available,

    otherwise try source}.  (This will only choose the binary package if

    otherwise try source}.  (This will only choose the binary package if

    its version number is no older than the source version.  In

    its version number is no older than the source version.  In

    interactive use it will ask before attempting to install source

    interactive use it will ask before attempting to install source

    where to save the outputs.  Ignored when installing from local

    where to save the outputs.  Ignored when installing from local

    files.

    files.

  }

  }

  \item{\dots}{

  \item{\dots}{

    Arguments to be passed to \code{\link{download.file}} or to the

    Arguments to be passed to \code{\link{download.file}} or to the

    an argument \code{"lock"}: see the section on \sQuote{Locking}).

    an argument \code{"lock"}: see the section on \sQuote{Locking}).

  }

  }

}

}

\details{

\details{

  \R packages are primarily distributed as \emph{source} packages, but

  \R packages are primarily distributed as \emph{source} packages, but

  \emph{binary} packages (a packaging up of the installed package) are

  \emph{binary} packages (a packaging up of the installed package) are

  also supported, and the type most commonly used on Windows and from

  also supported, and the type most commonly used on Windows and from

  type where supported, either by downloading a file from a repository

  type where supported, either by downloading a file from a repository

  or from a local file.  The default type is given by

  or from a local file.  The default type is given by

  \code{\link{getOption}("pkgType")}: this defaults to \code{"source"}

  \code{\link{getOption}("pkgType")}: this defaults to \code{"source"}

  This is the main function to install packages.  It takes

  This is the main function to install packages.  It takes

  a vector of names and a destination library, downloads the packages

  a vector of names and a destination library, downloads the packages

  from the repositories and installs them.  (If the library is omitted

  from the repositories and installs them.  (If the library is omitted

  it defaults to the first directory in \code{.libPaths()}, with a

  it defaults to the first directory in \code{.libPaths()}, with a

  single package, and for multiple packages when \code{Ncpus > 1L}.

  single package, and for multiple packages when \code{Ncpus > 1L}.

  Finally locking (and restoration on error) can be suppressed by

  Finally locking (and restoration on error) can be suppressed by

  \option{--no-lock}.

  \option{--no-lock}.

  % and also options(install.lock = FALSE) in an \R startup file.

  % and also options(install.lock = FALSE) in an \R startup file.

  default.  Setting argument \code{lock} to \code{TRUE} (it defaults to

  default.  Setting argument \code{lock} to \code{TRUE} (it defaults to

  the value of \code{\link{getOption}("install.lock", FALSE)}) will use

  the value of \code{\link{getOption}("install.lock", FALSE)}) will use

  per-directory locking as described for source installs: if the value

  per-directory locking as described for source installs: if the value

  is \code{"pkglock"} per-package locking will be used.

  is \code{"pkglock"} per-package locking will be used.