.\"  $HeadURL$ $LastChangedRevision$
.\" vim: filetype=nroff
.\"
.TH ADEINST 1 "ADE_APP_TOKEN_RELEASE_DATE_MAN"
.SH NAME
adeinst \- install program
.br
.ne 5
.SH SYNOPSIS
.B adeinst
\*[ade_standard_synopsis_component]
[
.B \-n
|
.B \-\-simulate
] 
[
.B \-m 
.I mode
|
.B \-\-perms=\fImode\fR
] 
{
.I srcfile dstfile 
| 
.I srcfile \fR...\fI dstdir
|
.B \-D \fI dir \fR...
}
.br
.ne 5
.SH DESCRIPTION
.B Adeinst
is an
.B install\fR(1)-like
program for installing programs and other files into target directories.
.PP
It operates in one of three modes corresponding to the following arguments:
.TP 25
.I srcfile dstfile
The single file
.I srcfile
is copied to 
.I dstfile\fR.
Any necessary leading directories will be created.
.TP
.I srcfile \fR ... \fI dstdir
All the specified source files are copied to the desination directory, which 
must already exist.
.TP
.B \-D \fIdir\fR ...
All the specified directories, and any missing leading directories, are
created.
.br
.ne 5
.SH CONFIGURATION
None.
.br
.ne 5
.SH OPTIONS
\*[ade_standard_options_component]
.TP
.B \-m \fImode\fR, \fB\-\-perms=\fImode\fR
Any files created will have the specified mode. Any directories
created will have their mode set to 
.I mode
plus the corresponding execute bits set, which is necessary for
directories.
This does not affect directories which already exist.
.TP
.B \-n\fR, \fB\-\-simulate\fR
Operate in simulate mode; no files or directories are written
or created.
.br
.ne 5
.SH EXIT STATUS
On success
.B adeinst
returns zero. On failure it returns non-zero and displays a diagnostic
message.
.br
.ne 5
.SH FILES
None.
.br
.ne 5
.SH ENVIRONMENT VARIABLES
None.
.br
.ne 5
.SH EXAMPLES
The following command would install a program \(oqfoo'
in /usr/local with a single file under the name \(oqbar'
with setgid \(oqmail':
.IP
.nf
.fam C
.B adeinst -m 755 foo /usr/local/bar
.fam T
.fi
.br
.ne 5
.SH CAVEATS
None.
.br
.ne 5
.SH STANDARDS
This manual page documents version ADE_APP_TOKEN_RELEASE_ID of
.B adeinst\fR.
.br
.ne 5
.SH SEE ALSO
install(1), ade-config(1)
.br
.ne 5
.SH AUTHOR
ADE_APP_TOKEN_AUTHOR_NAME <ADE_APP_TOKEN_AUTHOR_EMAIL>
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 1995-ADE_APP_TOKEN_RELEASE_YEAR ADE_APP_TOKEN_AUTHOR_NAME
\*[ade_standard_copyright_component]