|* If the destination directory does not exist, it is created (with any intermediate paths as needed).|
|* The list of files can be empty, so that when the list of installed files can be generated by configuration, you dont need to handle the empty case specially in Makefile. (With BSD install format, empty file list yields an error.)|
* The directory prefix of files are preserved within the
destination directory. This is handy to install subtree of files.
For example, the following command installs /usr/share/foo/main,
/usr/share/foo/conf/x and /usr/share/foo/conf/y with a
gauche-install -T /usr/share/foo main conf/x conf/y
Giving -p option suppresses this behavior and strips any directory prefix like the second format. The following command line installs /usr/share/foo/main, /usr/share/foo/x and /usr/share/foo/y.
gauche-install -T /usr/share/foo -p main conf/x conf/y
-C, --canonical-suffixThis is used specially to install Gauches autogenerated Scheme source by experimental precompilation. The generated file has a *.sci. Upon installation, this command replaces the suffix for *.scm.
-d, --directoryCreates directories. (3rd format only). It is only for the compatibility. Using the -T option, the destination directories are created automatically if missing.
-g, --group=GROUPChange group of the installed file.
-h, --helpShow summary of options.
-m, --mode=MODEChange mode of the installed file.
-n, --dry-runJust prints what actions to be done.
-o, --owner=OWNERChange owner of the installed file.
-p, --strip-prefix=PREFIXStrip PREFIX directories from FILE(s) before installation. (4th/5th format only).
--shebang=PATHAdds #!PATH before the file contents. Useful to install scripts.
-S, --srcdir=directoryLook for files within directory; useful if VPATH is used in Makefiles.
-T, --target=directoryInstalls files to the directory, creating paths if needed. Partial path of files are preserved unless -p option is given. (4th format only)
-U, --uninstall=directoryReverse of -T, e.g. removes files from its destination. Other options (except -h and -n) are ignored.
-v, --verboseWork verbosely.
gauche-install exits with status 0 on success.
The program will be documented fully by the Gauche Developers' Reference available via the info(1) system.
Shiro Kawai <email@example.com>
Jens Thiele <firstname.lastname@example.org>
Wrote this manpage for the Debian system.
Copyright © 2010 Jens Thiele
Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. This file is offered as-is, without any warranty.
|Gauche 0.9.4||GAUCHE-INSTALL (1)|