date and time created 88/10/21 11:13:20 by bostic

[unix-history] / usr / src / usr.bin / xinstall / install.1

diff --git a/usr/src/usr.bin/xinstall/install.1 b/usr/src/usr.bin/xinstall/install.1
index 0bdbb10..b79f98e 100644 (file)
--- a/usr/src/usr.bin/xinstall/install.1
+++ b/usr/src/usr.bin/xinstall/install.1
@@ -1,10 +1,21 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1987 Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)install.1   5.1 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms are permitted
+.\" provided that the above copyright notice and this paragraph are
+.\" duplicated in all such forms and that any documentation,
+.\" advertising materials, and other materials related to such
+.\" distribution and use acknowledge that the software was developed
+.\" by the University of California, Berkeley.  The name of the
+.\" University may not be used to endorse or promote products derived
+.\" from this software without specific prior written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

 .\"
 .\"

-.TH INSTALL 1 "22 April 1983"
+.\"    @(#)install.1   6.5 (Berkeley) %G%
+.\"
+.TH INSTALL 1 ""

 .UC 5
 .SH NAME
 install \- install binaries
 .UC 5
 .SH NAME
 install \- install binaries


@@ -20,49 +31,28 @@ owner ] [
 .B \-g
 group ] [
 .B \-s
 .B \-g
 group ] [
 .B \-s

-] binary destination
+] file1 file2; or file1 ... fileN directory

 .SH DESCRIPTION
 .SH DESCRIPTION

-.I Binary
-is moved (or copied if 
-.B \-c
-is specified) to
-.IR destination .
-If
-.I destination
-already exists,
-it is removed before
-.I binary
-is moved.
-If the destination is a directory then
-.I binary
-is moved into the
-.I destination
-directory with its original file-name.
+The file(s) are moved (or copied if the \fB-c\fP option is specified)
+to the target file or directory.  If the destination is a directory, then
+the \fIfile\fP is moved into \fIdirectory\fP with its original file-name.
+If the target file already exists, it is overwritten.

 .PP
 .PP

-The mode for
-.I Destination
-is set to 755; the
-.B \-m
-.I mode
-option may be used to specify a different mode.
+The mode is set to 755; the \fB-m\fP option may be used to specify
+an alternate mode.

 .PP
 .PP

-.I Destination
-is changed to owner root; the
-.B \-o
-.I owner
-option may be used to specify a different owner.
+The \fB-o\fP and \fB-g\fP options may be used to specify an owner
+and/or group, respectively.

 .PP
 .PP

-.I Destination
-is changed to group staff; the
-.B \-g
-.I group
-option may be used to specify a different group.
+The \fB-s\fP option causes the file to be stripped.  It is an error
+to attempt to strip a file not in the \fIa.out\fP format, but not to
+attempt to strip a file that has already been stripped.

 .PP
 .PP

-If the
-.B \-s
-option is specified the binary is stripped after being installed.
+\fIInstall\fP refuses to move a file onto itself.

 .PP
 .PP

-.I Install
-refuses to move a file onto itself.
+Installing ``/dev/null'' creates an empty file.
+.SH "RETURN VALUE"
+Upon successful completion a value of 0 is returned.  Otherwise, a
+value of 1 is returned.

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-chgrp(1), chmod(1), cp(1), mv(1), strip(1), chown(8)
+chgrp(1), chmod(1), cp(1), mv(1), strip(1), a.out(5), chown(8)