summaryrefslogtreecommitdiff
path: root/usr.bin/xinstall/install.1
diff options
context:
space:
mode:
authorJason McIntyre <jmc@cvs.openbsd.org>2004-02-06 22:21:11 +0000
committerJason McIntyre <jmc@cvs.openbsd.org>2004-02-06 22:21:11 +0000
commitc85890fbc0168626ae5ef8e7a9190efa92329ffd (patch)
tree68e8dd8138faee7603ee9153517cc1d7f507ff2e /usr.bin/xinstall/install.1
parent5fa9b63d3f4361055e33401ee7a34457d1c2b610 (diff)
- options description cleanup
- 10x not 6 for mkstemp(3)
Diffstat (limited to 'usr.bin/xinstall/install.1')
-rw-r--r--usr.bin/xinstall/install.155
1 files changed, 29 insertions, 26 deletions
diff --git a/usr.bin/xinstall/install.1 b/usr.bin/xinstall/install.1
index cc944db3471..8b8da949a72 100644
--- a/usr.bin/xinstall/install.1
+++ b/usr.bin/xinstall/install.1
@@ -1,4 +1,4 @@
-.\" $OpenBSD: install.1,v 1.19 2003/06/10 09:12:13 jmc Exp $
+.\" $OpenBSD: install.1,v 1.20 2004/02/06 22:21:10 jmc Exp $
.\" $NetBSD: install.1,v 1.4 1994/11/14 04:57:17 jtc Exp $
.\"
.\" Copyright (c) 1987, 1990, 1993
@@ -52,16 +52,14 @@
.Op Fl g Ar group
.Op Fl m Ar mode
.Op Fl o Ar owner
-.Ar file1
-\&...
+.Ar file1 ...
.Ar fileN directory
.Nm install
.Fl d
.Op Fl g Ar group
.Op Fl m Ar mode
.Op Fl o Ar owner
-.Ar directory
-\&...
+.Ar directory ...
.Sh DESCRIPTION
The file(s) are moved (or copied if the
.Fl c
@@ -78,12 +76,19 @@ if the
.Fl b
option is given
or overwritten
-if permissions allow, An alternate backup suffix may be specified via the
+if permissions allow.
+An alternate backup suffix may be specified via the
.Fl B
option's argument.
.Pp
The options are as follows:
-.Bl -tag -width Ds
+.Bl -tag -width "-B suffix"
+.It Fl B Ar suffix
+Use
+.Ar suffix
+as the backup suffix if
+.Fl b
+is given.
.It Fl b
Backup any existing files before overwriting them by renaming
them to
@@ -91,12 +96,6 @@ them to
See
.Fl B
for specifying a different backup suffix.
-.It Fl B Ar suffix
-Use
-.Ar suffix
-as the backup suffix if
-.Fl b
-is given.
.It Fl C
Copy the file.
If the target file already exists and the files are the same,
@@ -110,22 +109,26 @@ option is only included for backwards compatibility.
.It Fl d
Create directories.
Missing parent directories are created as required.
-.It Fl f
-Specify the target's file flags.
+.It Fl f Ar flags
+Specify the target's file
+.Ar flags .
(See
.Xr chflags 1
for a list of possible flags and their meanings.)
-.It Fl g
-Specify a group.
+.It Fl g Ar group
+Specify a
+.Ar group .
A numeric GID is allowed.
-.It Fl m
-Specify an alternate mode.
+.It Fl m Ar mode
+Specify an alternate
+.Ar mode .
The default mode is set to rwxr-xr-x (0755).
The specified mode may be either an octal or symbolic value; see
.Xr chmod 1
for a description of possible mode values.
-.It Fl o
-Specify an owner.
+.It Fl o Ar owner
+Specify an
+.Ar owner .
A numeric UID is allowed.
.It Fl p
Preserve the modification time.
@@ -171,7 +174,7 @@ Installing
creates an empty file.
.Pp
Upon successful completion a value of 0 is returned.
-Otherwise, a value >0 is returned.
+Otherwise, a value \*(Gt0 is returned.
.Sh ENVIRONMENT
.Bl -tag -width "STRIP"
.It Ev STRIP
@@ -182,8 +185,8 @@ Default is
.Pa /usr/bin/strip .
.El
.Sh FILES
-.Bl -tag -width INS@XXXXXX -compact
-.It Pa INS@XXXXXX
+.Bl -tag -width INS@XXXXXXXXXX -compact
+.It Pa INS@XXXXXXXXXX
If either
.Fl S
option is specified, or the
@@ -192,8 +195,8 @@ or
.Fl p
option is used in conjunction with the
.Fl s
-option, temporary files named INS@XXXXXX,
-where XXXXXX is decided by
+option, temporary files named INS@XXXXXXXXXX,
+where XXXXXXXXXX is decided by
.Xr mkstemp 3 ,
are created in the target directory.
.El