1GAUCHE-INSTALL(1)               Gauche Commands              GAUCHE-INSTALL(1)
2
3
4

NAME

6       gauche-install - install files and set attributes
7

SYNOPSIS

9         1)* gauche-install [OPTION...] FILE DEST
10         2)* gauche-install [OPTION...] FILE... DIRECTORY
11         3)* gauche-install -d [OPTION...] DIRECTORY...
12         4)  gauche-install -T DIRECTORY [OPTION...] FILE...
13         5)  gauche-install -U DIRECTORY [OPTION...] FILE...
14

DESCRIPTION

16       gauche-install is a program to install and remove files.  On
17       installation it allows to set ownership and permissions.  This command
18       is upward compatible with BSD install(1) and can be used as a drop-in
19       replacement of it.   Notably, 1st, 2nd and 3rd command-line format
20       above are compatible with BSD install.
21
22       This command is provided mainly for Gauche's extension packages to have
23       simpler installation and configuration process.   Being certain that
24       gauche-install is available, those packages don't need to worry about
25       subtle differences between various install(1) commands.
26
27       The first format copies FILE on the file or in the directory named by
28       DEST.  The second format copies FILE ...  into the directory DIRECTORY.
29
30       The third format ensures DIRECTORY exists.  If it doesn't, the command
31       creates the path to the DIRECTORY , including any intermediate ones.
32
33       The fourth format installing FILE ...  to the DIRECTORY.  It is more
34       convenient than the first and second formats in the following regards:
35
36          * If the destination directory does not exist, it is created (with
37          any intermediate paths as needed).
38
39          * The list of files can be empty, so that when the list of installed
40          files can be generated by configuration, you don't need to handle
41          the empty case specially in Makefile.  (With BSD install format,
42          empty file list yields an error.)
43
44          * The directory prefix of files are preserved within the destination
45          directory.  This is handy to install subtree of files.  For example,
46          the following command installs '/usr/share/foo/main',
47          '/usr/share/foo/conf/x' and '/usr/share/foo/conf/y' with a single
48          command.
49
50            gauche-install -T /usr/share/foo main conf/x conf/y
51
52          Giving -p option suppresses this behavior and strips any directory
53          prefix like the second format.  The following command line installs
54          '/usr/share/foo/main', '/usr/share/foo/x' and '/usr/share/foo/y'.
55
56            gauche-install -T /usr/share/foo -p main conf/x conf/y
57
58       The fifth format removes FILE ...  in the DIRECTORY.  Irrelevant
59       options are ignored, so it is handy to uninstall files just by chaning
60       -T in the fourth format to -U.
61

OPTIONS

63       -C, --canonical-suffix
64           This is used specially to install Gauche's autogenerated Scheme
65           source by experimental precompilation.  The generated file has a
66           *.sci.  Upon installation, this command replaces the suffix for
67           *.scm.
68
69       -d, --directory
70           Creates directories. (3rd format only).  It is only for the
71           compatibility.  Using the -T option, the destination directories
72           are created automatically if missing.
73
74       -g, --group=GROUP
75           Change group of the installed file.
76
77       -h, --help
78           Show summary of options.
79
80       -m, --mode=MODE
81           Change mode of the installed file.
82
83       -n, --dry-run
84           Just prints what actions to be done.
85
86       -o, --owner=OWNER
87           Change owner of the installed file.
88
89       -p, --strip-prefix=PREFIX
90           Strip PREFIX directories from FILE(s) before installation. (4th/5th
91           format only).
92
93       --shebang=PATH
94           Adds #!PATH before the file contents. Useful to install scripts.
95
96       -S, --srcdir=directory
97           Look for files within directory; useful if VPATH is used in
98           Makefiles.
99
100       -T, --target=directory
101           Installs files to the directory, creating paths if needed.  Partial
102           path of files are preserved unless -p option is given.  (4th format
103           only)
104
105       -U, --uninstall=directory
106           Reverse of -T, e.g. removes files from its destination.  Other
107           options (except -h and -n) are ignored.
108
109       -v, --verbose
110           Work verbosely.
111

DIAGNOSTICS

113       gauche-install exits with status 0 on success.
114

SEE ALSO

116       gauche-package(1), install(1)
117
118       The program will be documented fully by the Gauche Developers´
119       Reference available via the info(1) system.
120

AUTHORS

122       Shiro Kawai <shiro@acm.org>
123           Author.
124
125       Jens Thiele <karme@karme.de>
126           Wrote this manpage for the Debian system.
127
129       Copyright © 2010 Jens Thiele
130
131       Copying and distribution of this file, with or without modification,
132       are permitted in any medium without royalty provided the copyright
133       notice and this notice are preserved. This file is offered as-is,
134       without any warranty.
135
136
137
138
139Gauche 0.9.11                                                GAUCHE-INSTALL(1)
Impressum