.\"  $HeadURL$ $LastChangedRevision$
.\"
.TH ADEINST 1 "ADE_APP_TOKEN_RELEASE_DATE_MAN"
.SH NAME
adeinst \- GNU-compatible install program
.br
.ne 5
.SH SYNOPSIS
.B adeinst
[
.B \-V
|
.B \-\-version
] [
.B \-v
|
.B \-\-verbose
|
.B \-\-debug=\fIlevel\fR
] [
.B \-h
|
.B \-\-help
] [
.B \-p
|
.B \-\-list\-paths
] 
[
.B \-n
|
.B \-\-simulate
] [
.B \-m 
.I mode
|
.B \-\-perms=\fImode\fR
] [
.B \-o
.I owner
|
.B \-\-owner=\fIowner\fR
] [
.B \-g
.I group
|
.B \-\-group=\fIgroup\fR
] {
.I srcfile dstfile 
| 
.I srcfile \fR...\fI dstdir
|
.B \-d \fI dir \fR...
}
.br
.ne 5
.SH DESCRIPTION
This manual page documents version ADE_APP_TOKEN_RELEASE_ID of 
.B adeinst\fR.
.PP 
.B Adeinst
is a GNU-compatible
.B install\fR(1)
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 dstfile
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
.TP 25
.B \-\-debug=\fIlevel\fR
Determines how verbose
.B adetest
will be. The message types displayed for the different values of 
.I level
are as follows:
.RS 25
.TP 5
.B 0
internal errors only
.TP
.B 1
internal errors and normal errors 
.TP
.B 2
internal errors, normal errors and warnings
.TP 
.B 3
internal errors, normal errors, warnings and informational messages
.TP 
.B >3
all the above plus application-specific debug messages.
.RE
.TP
.B \-g \fIgroup\fR, \fB\-\-group=\fIgroup\fR
Any files or directories created will belong to the specified group.
This does not affect directories which already exist.
.TP
.B \-h\fR, \fB\-\-help
Displays a brief usage message.
.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.
.TP
.B \-o \fIowner\fR, \fB\-\-owner=\fIowner\fR
Any files or directories created will belong to the specified user.
This does not affect directories which already exist.
.TP
.B \-p\fR, \fB\-\-list\-paths
List the compiled-in paths of various files and directories that
.B adetest
uses.
.TP 
.B \-v\fR, \fB\-\-verbose
Equivalent to
.B \-d 3\fR.
.TP
.B \-V\fR, \fB\-\-version
Print the program's version number and exit.
.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 -o mail -m 1755 foo /usr/local/bar
.fam T
.fi
.br
.ne 5
.SH CAVEATS
None.
.br
.ne 5
.SH SEE ALSO
install(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
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.