Add options -C (same as -c except for preserving the modification

time of the target if the target file is the same as the source),
-d (debug), and -p (same as -C except for preserving the modification
time of the source if the target doesn't exists or is different from
the source.

Use library err() functions instead of our own and pass them better
exit codes.

Submitted by:	wollman (and changed a lot by me)

1 files changed, 44 insertions, 3 deletions

diff --git a/usr.bin/xinstall/install.1 b/usr.bin/xinstall/install.1
index c35c7a5..84ec638 100644
--- a/usr.bin/xinstall/install.1
+++ b/usr.bin/xinstall/install.1
@@ -29,9 +29,10 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"     @(#)install.1	8.1 (Berkeley) 6/6/93
+.\"	From: @(#)install.1	8.1 (Berkeley) 6/6/93
+.\"	$Id$
 .\"
-.Dd June 6, 1993
+.Dd October 9, 1995
 .Dt INSTALL 1
 .Os BSD 4.2
 .Sh NAME
@@ -46,7 +47,7 @@
 .Op Fl o Ar owner
 .Ar file1 file2
 .Nm install
-.Op Fl cs
+.Op Fl Ccdps
 .Op Fl f Ar flags
 .Op Fl g Ar group
 .Op Fl m Ar mode
@@ -67,11 +68,29 @@ If the target file already exists, it is overwritten if permissions
 allow.
 .Pp
 .Bl -tag -width Ds
+.It Fl C .
+Copy the file, as if the
+.Fl c
+option is specifed,
+except if the target file already exists and the files are the same,
+then don't change the modification time of the target
 .It Fl c
 Copy the file.
 This flag turns off the default behavior of
 .Nm install
 where it deletes the original file after creating the target.
+.It Fl d
+Print debugging information.
+If
+.Fl d
+is specified one or more times,
+then print the renaming steps for
+.Fl C .
+If
+.Fl d
+is specified two or more times,
+then warn about files that aren't installed with
+.Fl C .
 .It Fl f
 Specify the target's file flags.
 (See
@@ -87,6 +106,13 @@ The specified mode may be either an octal or symbolic value; see
 for a description of possible mode values.
 .It Fl o
 Specify an owner.
+.It Fl p
+Preserve the modification time.
+Copy the file, as if the
+.Fl C
+(Compare and copy) option is specifed,
+except if the target file doesn't already exist or is different,
+then preserve the modification time of the file.
 .It Fl s
 .Nm Install
 exec's the command
@@ -109,6 +135,17 @@ creates an empty file.
 .Pp
 Upon successful completion a value of 0 is returned.
 Otherwise, a value of 1 is returned.
+.Sh FILES
+.Bl -tag -width INS@XXXX -compact
+.It Pa INS@XXXX
+If the
+.Fl C
+or
+.Fl p
+option is used, then temporary files named INS@XXXX,
+where XXXX is decided by
+.Xr mkstemp 3 ,
+are created in the target directory.
 .Sh SEE ALSO
 .Xr chflags 1 ,
 .Xr chgrp 1 ,
@@ -122,3 +159,7 @@ The
 .Nm install
 utility appeared in
 .Bx 4.2 .
+.Sh BUGS
+Temporary files may be left in the target directory if
+.Nm install
+exits abnormally.