The R Project SVN R

#! /bin/sh
#
# ${R_HOME}/bin/INSTALL for installing add-on packages

# @configure_input@

revision='$Revision: 1.99 $'
version=`set - ${revision}; echo ${2}`
version="R add-on package installer ${version}

Copyright (C) 2000-2002 The R Core Development Team.
This is free software; see the GNU General Public Licence version 2
or later for copying conditions.  There is NO warranty."

usage="Usage: R CMD INSTALL [options] pkgs

Install the add-on packages specified by pkgs.  The elements of pkgs can
be relative or absolute paths to directories with the package (bundle)
sources, or to gzipped package 'tar' archives.  The library tree to
install to can be specified via '--library'.  By default, packages are
installed in the library tree rooted at the first directory given in the
environment variable R_LIBS if this is set and non-null, and into the
default R library tree (${R_HOME}/library) otherwise.

Options:
  -h, --help        print short help message and exit
  -v, --version     print version info and exit
      --configure-args=ARGS
                        set arguments for the package's configure script
            (if any)
      --configure-vars=VARS
                        set variables for the configure script (if any)
  -c, --clean       remove all files created during installation
  -s, --save[=ARGS]     save the package source as an image file, and
                        arrange for this file to be loaded when the
                        package is attached; if given, ARGS are passed
                        to R when creating the save image
      --no-save         do not save the package source as an image file
  -d, --debug       turn on shell and build-help debugging
  -l, --library=LIB install packages to library tree LIB
      --no-configure    do not use the package's configure script
      --no-docs     do not build and install documentation
      --use-zip-data    collect data files in zip archive
      --use-zip-help    collect help and examples into zip archives
      --use-zip     combine '--use-zip-data' and '--use-zip-help'

Report bugs to <r-bugs@r-project.org>."

## <NOTE>
## This is a *shell* script.
## According to the R Coding Standards (see R-exts), Perl can be assumed
## for *source*, but not for *binary* installations.
## </NOTE>

## <FIXME>
## This uses
##   mkdir -p
##   basename
## which are not portable.
## We could fix this using suitable shell replacements, but we should
## really redo as much as we can using R code.
## </FIXME>

umask 022

R_VERSION='@VERSION@'
GETWD='@GETWD@'
MAKE=${MAKE-'@MAKE@'}
NO_PERL5=@NO_PERL5@
NO_PERL5_MSG="\
*** Formatting and installing R help pages needs Perl version 5, which
*** does not seem to be installed on your system or is not in your path.
*** Please install either Perl 5 on your system and re-configure R or
*** get the PDF reference manual from the nearest CRAN server.
*** The CRAN master site can be found at
***    http://cran.r-project.org/"
tmpdir="${TMPDIR-/tmp}/R.INSTALL.$$"

: ${R_OSTYPE=unix}
## <NOTE>
## Unix only ... but Windows has INSTALL as a Perl script.
R_EXE="${R_HOME}/bin/R"
## </NOTE>

## <NOTE>
## It might make sense to abstract error and warnings into functions
## like
##   warning () { echo "WARNING: $*" }
##   error ()   { echo "ERROR: $*" }
## and maybe even redirect this to stderr on Unix.
## </NOTE>

## <NOTE>
## This could be made a bit more general: if R CMD INSTALL is run by
## another tool (e.g., when building or checking a package, its messages
## should be a section level deeper (at least).  So we could have an
## argument to set the initial secnumdepth (0 by default), and work
## against this ...
message () { echo "${stars} $*"; }
stars="*"
## </NOTE>

. "${R_HOME}/share/sh/dcf.sh"   # get_dcf_field()

get_packages () {
  ## get the full path names to all packages contained in $1.
  ## NOTE: modifies pkgs!
  if grep -s "^Contains:" "${1}/DESCRIPTION"; then
    bundlepkg=`get_dcf_field Contains "${1}/DESCRIPTION"`
    for p in ${bundlepkg}; do
      pkgs="${pkgs} \"`cd "${1}/${p}" && ${GETWD}`\""
      if test -f "${1}/${p}/DESCRIPTION.in"; then
        cat "${1}/${p}/DESCRIPTION.in"  > "${1}/${p}/DESCRIPTION"
        grep -v "^Contains:" "${1}/DESCRIPTION" >> "${1}/${p}/DESCRIPTION"
      fi
    done
  else 
    pkgs="${pkgs} \"`cd "${1}" && ${GETWD}`\""
  fi
}

if test -n "${R_LIBS}"; then
  lib=`echo "${R_LIBS}" | cut -f1 -d:`
else
  lib="${R_HOME}/library"
fi

pkgs=
clean=false
debug=false
error=false
build_text=true
build_html=true
build_latex=true
build_example=true
build_help=true
build_help_opts=
use_configure=true
use_zip_data=
use_zip_help=
configure_args=
configure_vars=

save="CHECK"
save_args="--no-site-file --no-init-file";

while test -n "${1}"; do
  case ${1} in
    -h|--help)
      echo "${usage}"; exit 0 ;;
    -v|--version)
      echo "${version}"; exit 0 ;;
    -c|--clean)
      clean=true ;;
    -s|--save)
      save=true;;
    --save=*)
      save_args=`echo "${1}" | sed -e 's/[^=]*=//'` ;;
    --no-save)
      save=false ;;
    -d|--debug)
      debug=true ;;
    --no-configure)
      use_configure=false ;;
    --no-docs)
      build_text=false
      build_html=false
      build_latex=false
      build_example=false ;;
    --no-text)
      build_text=false ;;
    --no-html)
      build_html=false ;;
    --no-latex)
      build_latex=false ;;
    --no-example)
      build_example=false ;;
    --use-zip)
      use_zip_data=true
      use_zip_help=true ;;
    --use-zip-data)
      use_zip_data=true ;;
    --use-zip-help)
      use_zip_help=true ;;
    -l|--library)
      lib="${2}"; shift ;;
    --library=*)
      lib=`echo "${1}" | sed -e 's/[^=]*=//'` ;;
    --configure-args=*)
      configure_args=`echo "${1}" | sed -e 's/[^=]*=//'` ;;
    --configure-vars=*)
      configure_vars=`echo "${1}" | sed -e 's/[^=]*=//'` ;;
    *)
      if test -f "${1}"; then
        mkdir -p ${tmpdir}
    pkgname=`basename "${1}"`
    ## Also allow for 'package.tgz' ...
    pkgname=`basename "${pkgname}" .tgz`
    pkgname=`echo "${pkgname}" | sed 's/_.*//'`
    ## Note that we use '-m' so that modification dates are *not*
    ## preserved when untarring the sources.  This is necessary to
    ## ensure that the preformatted help pages are always rebuilt.
    ## Otherwise, the build date for an older version may be newer
    ## than the modification date for the new sources as recorded in
    ## the tarball ...
    gzip -dc "${1}" | (cd "${tmpdir}" && tar -mxf -)
    if test -d "${tmpdir}/${pkgname}"; then
      get_packages "${tmpdir}/${pkgname}"
    else
      echo "ERROR: cannot extract package from '${1}'"
      exit 1
    fi    
      elif test -d "${1}"; then
        get_packages "${1}"
      else
    echo "WARNING: package '${1}' does not exist"
      fi
      ;;
  esac
  shift
done

if test -z "${pkgs}"; then
  echo "ERROR: no packages specified"
  exit 1
fi

if test -d "${lib}" -a -w "${lib}" || mkdir "${lib}" 2> /dev/null; then
  lib=`cd "${lib}" && ${GETWD}`
else
  echo "ERROR: cannot write to or create directory '${lib}'"
  exit 2
fi

if ${build_text}; then
  build_help_opts="${build_help_opts} --txt"
fi
if ${build_html}; then
  build_help_opts="${build_help_opts} --html"
fi
if ${build_latex}; then
  build_help_opts="${build_help_opts} --latex"
fi
if ${build_example}; then
  build_help_opts="${build_help_opts} --example"
fi
if test -z "${build_help_opts}"; then
  build_help=false
elif ${debug}; then
  build_help_opts="--debug ${build_help_opts}"
fi

do_install () {
  cd "${1}"
  pkg=`basename "${1}"`

  depends=`get_dcf_field Depends DESCRIPTION`
  depends=`echo "${depends}" | grep 'R *('`
  if test "${depends}"; then
    depends=`echo "${depends}" | sed 's/.*R *(\([^)]*\)).*/\1/;s/=/= /'`
    dep_operator=`set - ${depends}; echo ${1}`
    dep_version=`set - ${depends}; echo ${2}`
    ## Currently, only operators `<=' and `>=' are supported.  Hence we
    ## check this, and also whether we found a version string.
    if (test "${dep_operator}" = "<=" \
    || test "${dep_operator}" = ">=") \
    && test -n "${dep_version}"; then
      dep_ok=`expr ${R_VERSION} ${dep_operator} ${dep_version} `
      if test ${dep_ok} -eq 0; then
    echo "ERROR: This R is version ${R_VERSION}"
    echo "       package '${pkg}' depends on R ${dep_version}"
    exit 1;
      fi
    else
      echo "WARNING: malformed 'Depends' field in 'DESCRIPTION'"
    fi
  fi

  mkdir -p "${lib}/${pkg}" || exit 2

  ## Make sure we do not attempt installing to srcdir.
  if test "`cd \"${lib}/${pkg}\" && ${GETWD}`" = "`${GETWD}`"; then
    echo "ERROR: cannot install to srcdir"
    exit 3
  fi  

  ## Figure out whether this is a source or binary package.
  ## <NOTE>
  ## If DESCRIPTION has a @samp{Built:} entry, this is a binary package.
  ## This is the right test, but not available for packages installed
  ## prior to R 1.4.  For some time, we thus checked for the existence
  ## of a 'man' subdir if no build information was found in DESCRIPTION,
  ## using the fact that versions of R prior to 1.4 also did not install
  ## documentation sources, and assuming that all source packages would
  ## have some documentation, which caused problems for people who had
  ## not yet written any docs ... hence, from R 1.6 on only DESCRIPTION
  ## is looked at.
  ## </NOTE>
  if grep "^Built:" DESCRIPTION >/dev/null ; then
    ## If DESCRIPTION has a @samp{Built:} entry this is a binary
    ## package.  This is the right test, but not available for packages
    ## installed prior to 1.4.0.
    is_source_package=false
  else
    is_source_package=true
  fi

  if ${is_source_package}; then
    ## This is a source package ... hopefully.
    message "Installing *source* package '${pkg}' ..."
    stars="**"

    ## Make the destination directories available to the developer's
    ## installation scripts (e.g. configure, etc.)
    R_PACKAGE_DIR="${lib}/${pkg}"
    R_LIBRARY_DIR="${lib}"
    R_PACKAGE_NAME="${pkg}"
    export R_LIBRARY_DIR
    export R_PACKAGE_DIR
    export R_PACKAGE_NAME

    if ${use_configure} && test -x ./configure ; then
      eval ${configure_vars} ./configure ${configure_args}
      if test ${?} -ne 0; then
    echo "ERROR: configuration failed for package '${pkg}'"
    exit 4
      fi
    fi

    if test -d src; then
      message "libs"
      if ${debug}; then set -x; fi
      mkdir -p "${lib}/${pkg}/libs"
      if test -f src/Makefile; then
        cd src;
        makefiles="-f \"${R_HOME}\"/share/make/shlib.mk -f Makefile"
    if test -r Makevars; then
      makefiles="-f Makevars ${makefiles}"
    fi
    eval ${MAKE} ${makefiles} \
      && cp *@SHLIB_EXT@ "${lib}/${pkg}/libs" \
      || error=true; \
    if ${clean}; then
      ${MAKE} clean
    fi
    cd ..
      else
        cd src;
        srcs=`ls *.[cfC] *.cc *.cpp 2>/dev/null`
    if test -n "${srcs}"; then
      sh "${R_HOME}/bin/SHLIB" -o "${pkg}@SHLIB_EXT@" ${srcs} \
        && cp *@SHLIB_EXT@ "${lib}/${pkg}/libs" \
        || error=true; \
      if ${clean}; then
        rm -rf .libs _libs
        rm -f *.o *@SHLIB_EXT@
      fi
    else
      echo "WARNING: no source files found"
    fi
    cd ..
      fi
      if ${error}; then
    echo "ERROR: compilation failed for package '${pkg}'"
    exit 5
      fi
      if ${debug}; then set +x; fi
    fi

    if test -d R; then
      message "R"
      Rfiles=`LC_COLLATE=C ls R/*.[RSqrs] R/${R_OSTYPE}/*.[RSqrs] 2>/dev/null`
      if test -n "${Rfiles}"; then
        mkdir -p "${lib}/${pkg}/R"
    rm -f "${lib}/${pkg}/R/"*
    echo ".packageName <- \"${pkg}\"" > "${lib}/${pkg}/R/${pkg}"
        cat ${Rfiles} >> "${lib}/${pkg}/R/${pkg}"
      fi
    fi

    if test -d data; then
      message "data"
      mkdir -p "${lib}/${pkg}/data"
      rm -f "${lib}/${pkg}/data/"*
      cp data/* "${lib}/${pkg}/data" 2>/dev/null
      chmod 644 "${lib}/${pkg}/data/"*
      if test -n "${use_zip_data}" \
          -a -n "${R_UNZIPCMD}" \
          -a -n "${R_ZIPCMD}"; then
        (cd "${lib}/${pkg}/data";
          find . -type f -print > filelist
          ${R_ZIPCMD} -m Rdata * -x filelist 00Index)
      fi
    fi

    if test -d demo; then
      message "demo"
      mkdir -p "${lib}/${pkg}/demo"
      rm -f "${lib}/${pkg}/demo/"*
      cp demo/* "${lib}/${pkg}/demo" 2>/dev/null
      chmod 644 "${lib}/${pkg}/demo/"*
    fi

    if test -d exec; then
      message "exec"
      mkdir -p "${lib}/${pkg}/exec"
      rm -f "${lib}/${pkg}/exec/"*
      cp exec/* "${lib}/${pkg}/exec" 2>/dev/null
      chmod 755 "${lib}/${pkg}/exec/"*
    fi

    if test -d inst; then
      message "inst"
      cp -r inst/* "${lib}/${pkg}"
    fi

    case ${save} in
      CHECK)
    if test -r install.R; then
      R_SAVE_IMAGE=true;
        else
      R_SAVE_IMAGE=false;
        fi
    ;;
      *)
    R_SAVE_IMAGE=${save} ;;
    esac
    export R_SAVE_IMAGE

    if ${R_SAVE_IMAGE}; then
      message "save image"
      ## <NOTE>
      ## We want R to run as quietly as possible when creating the save
      ## image.  But this is tricky: sending options(echo=FALSE) to R via
      ## stdin (as opposed to writing to a file and reading from it)
      ## echoes what we sent before shutting up R, which is not what we
      ## want.  Option '--slave' gets around this but also turns off
      ## saving ... hence we call R with '--slave --save'.  Argh.
      save_image_defaults="list(compress=TRUE, safe=FALSE)"
      (echo "options(save.image.defaults=${save_image_defaults})"; \
        if test -s R_PROFILE.R; then cat R_PROFILE.R; fi; \
        echo "invisible(.libPaths(c(\"${lib}\", .libPaths())))"; \
        cat "${lib}/${pkg}/R/${pkg}") | \
      ${R_EXE} --slave --save ${save_args}
      ## </NOTE>
      if test ${?} -ne 0; then
        echo "ERROR: execution of package source for '${pkg}' failed"
    exit 1
      fi
      mv .RData "${lib}/${pkg}/R/all.rda"
      mv "${lib}/${pkg}/R/${pkg}" "${lib}/${pkg}/R/${pkg}.R"
      cat "${R_HOME}/share/R/firstlib.R" > "${lib}/${pkg}/R/${pkg}"
      ## If install.R is non-empty, arrange to evaluate the R code it
      ## contains after the package source (maybe for some kind of
      ## cleanup).
      if test -s install.R; then
        cat install.R >> "${lib}/${pkg}/R/${pkg}"
      fi
    fi

    for f in COPYING INDEX; do
      if test -f "${f}"; then cp "${f}" "${lib}/${pkg}"; fi
    done
    ## Copy DESCRIPTION file, stamp with build information, and remove
    ## blank lines.  (Need to add an empty line to deal with missing
    ## trailing newlines at EOF.)
    ## As from 1.7.0, packages without compiled code are not marked
    ## as being from any platform.
    if test -f DESCRIPTION; then
      ## <FIXME>
      ## What if there is no DESCRIPTION file?
      ## Shouldn't we fail right away then?
      ## </FIXME>
      (echo "library(tools)"; \
        echo ".installPackageDescription(\".\", \"${lib}/${pkg}\")") | \
      ${R_EXE} --vanilla >/dev/null
    fi

    if test -d man; then
      message "help"
      ## Install man sources ...
      Rdfiles=`ls man/*.[Rr]d man/${R_OSTYPE}/*.[Rr]d 2>/dev/null`
      if test -n "${Rdfiles}"; then
    mkdir -p "${lib}/${pkg}/man"
    rm -f "${lib}/${pkg}/man/"*
    cat ${Rdfiles} > "${lib}/${pkg}/man/${pkg}.Rd"
    chmod 644 "${lib}/${pkg}/man/${pkg}.Rd"
      fi
      ## Maybe build preformatted help pages ...
      if ${build_help}; then
    if ${NO_PERL5}; then
      echo "${NO_PERL5_MSG}"
    else
      if ${debug}; then
        echo "DEBUG: build-help ${BUILD_HELP_OPTS} ../${pkg} ${lib}"
      fi
      ${R_CMD} perl "${R_HOME}/share/perl/build-help.pl" \
        ${build_help_opts} "../${pkg}" "${lib}"
      if test ${?} -ne 0; then
        echo "ERROR: building help failed for package '${pkg}'"
        exit 6
      fi
      if test "${lib}" = `cd "${R_HOME}/library" && ${GETWD}`; then
        ${R_CMD} perl "${R_HOME}/share/perl/build-help.pl" --htmllists
      fi
        fi
    if test -n "${use_zip_help}" \
            -a -n "${R_UNZIPCMD}" \
        -a -n "${R_ZIPCMD}"; then
      (cd "${lib}/${pkg}"
        if test -d R-ex; then
          (cd R-ex; ${R_ZIPCMD} -m Rex *.R)
        fi
        ## NOT YET:
        ## if test -d latex; then
        ##   (cd latex; ${R_ZIPCMD} -m Rhelp *.tex)
        ## fi
        if test -d help; then
          (cd help; ${R_ZIPCMD} -m Rhelp * -x AnIndex);
        fi)
        fi
      fi
      (echo "library(tools)"; \
    echo ".installPackageIndices(\".\", \"${lib}/${pkg}\")") | \
      ${R_EXE} --vanilla >/dev/null
      if test "${lib}" = `cd "${R_HOME}/library" && ${GETWD}`; then
    cat "${R_HOME}"/library/*/CONTENTS \
      > "${R_HOME}"/doc/html/search/index.txt
      fi    
    else
      echo "No man pages found in package '${pkg}'"
    fi

    if ${clean}; then
      if test -x ./cleanup ; then
    ./cleanup
      fi
    fi

    stars="*"
  else  
    ## This is a binary package ... hopefully.
    message "Installing *binary* package '${pkg}' ..."
    cp -r . "${lib}/${pkg}"
  fi

  chmod -R a+r "${lib}/${pkg}"

  message "DONE (${pkg})"
  echo
}

eval "for pkg in ${pkgs}; do do_install \"\${pkg}\"; done"

cp "${R_HOME}/doc/html/R.css" "${lib}"

if test -d "${tmpdir}"; then
  cd /
  rm -rf "${tmpdir}"
fi

message "DONE (INSTALL)"

### Local Variables: ***
### mode: sh ***
### sh-indentation: 2 ***
### End: ***