Install S-PLUS Objects

DESCRIPTION:

A S-PLUS package utility to install S-PLUS code or data objects from source files into the .Data directory of a specified destination directory.

USAGE:

Splus CMD SINSTALL --destdir dirName [files]
Splus CMD DATAINSTALL --destdir dirName [files]

REQUIRED ARGUMENTS:

--destdir dirName
the path to the directory where the S-PLUS objects will be installed. If that directory contains a .Data directory, then the objects will be put there, otherwise a .Data directory will be created in the destination directory.

OPTIONAL ARGUMENTS:

files
names of source files to be installed. If names are omitted, SINSTALL will install all files found in the current working directory having these extensions: .q, .R, .ssc, .SSC, .S. If names are omitted, DATAINSTALL will install all files found in the current working directory having these extensions: .txt, .TXT, .csv, .CSV, .q, .R, .ssc, .SSC, .S, .tab, .TAB, .Rdata, .rdata, .rda.
-h, --help
print usage message.
--clean-first
remove all installed objects before installing new objects. All files, except for the S-PLUS audit file, are removed from the .Data and .Data/__Meta directories.
--clean-after
remove unneeded files after installation. This option is not yet implemented.
--no-clean-after
do not remove unneeded files and directories after installation. This option is not yet implemented.
-v, --verbose
give more detailed progress reports.

SIDE EFFECTS:

A .Data directory is created and initialized in the destination directory if one does not exist. If the --clean-first option is given, then all objects are deleted from the .Data directory initially. If file names are included on the command line, then the data or objects in those files will be installed into the .Data directory of the destination directory. If no file names are given, then all S-PLUS source files in the current directory having the appropriate file extension, depending on whether SINSTALL or DATAINSTALL is being invoked, will be installed.

DETAILS:

If a .Data directory already exists in the destination directory, it must be writable.

Currently, the --clean-after and --no-clean-after options are not implemented.

The SINSTALL and DATAINSTALL utilities are invoked from the operating system's command line using the S-PLUS CMD utility. These utilities are based on Perl code.

SEE ALSO:

Read Guide to S-PLUS Packages for more information.
S-PLUS functions: and (in library pkgutils).
Other package utilities: , , , .

EXAMPLES:

# re-install all the objects in the package, cleaning .Data first
# (current working directory contains the package directory, myPkg)
Splus CMD SINSTALL --destdir myPkg --clean-first myPkg/R/*
Splus CMD DATAINSTALL --destdir myPkg myPkg/data/*

# install specific source files (current working directory is
# the package directory)
Splus CMD SINSTALL --destdir .  R/func1.S  R/func2.S

# re-install all the data objects in the package (current working 
# directory is the package's "data" directory)
Splus CMD DATAINSTALL --destdir ..