file_cmds-321.100.10.0.1.tar.gz

[apple/file_cmds.git] / install / install.1

diff --git a/install/install.1 b/install/install.1
index b3e62413d631f4dc8572d01a1893b307b8523d93..76f36978cfc71b1c5e157a8fa5e02ddf6609e6dd 100644 (file)
--- a/install/install.1
+++ b/install/install.1
@@ -39,7 +39,7 @@
 .Nm install
 .Nd install binaries
 .Sh SYNOPSIS
-.Nm
+.Nm install
 .Op Fl bCcMpSsv
 .Op Fl B Ar suffix
 .Op Fl f Ar flags
@@ -47,7 +47,7 @@
 .Op Fl m Ar mode
 .Op Fl o Ar owner
 .Ar file1 file2
-.Nm
+.Nm install
 .Op Fl bCcMpSsv
 .Op Fl B Ar suffix
 .Op Fl f Ar flags
@@ -55,7 +55,7 @@
 .Op Fl m Ar mode
 .Op Fl o Ar owner
 .Ar file1 ... fileN directory
-.Nm
+.Nm install
 .Fl d
 .Op Fl v
 .Op Fl g Ar group
@@ -84,6 +84,14 @@ option's argument.
 .Pp
 The options are as follows:
 .Bl -tag -width indent
+.\" ==========
+.It Fl B Ar suffix
+Use
+.Ar suffix
+as the backup suffix if
+.Fl b
+is given.
+.\" ==========
 .It Fl b
 Back up any existing files before overwriting them by renaming
 them to
@@ -91,44 +99,47 @@ 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,
 then don't change the modification time of the target.
+.\" ==========
 .It Fl c
 Copy the file.
 This is actually the default.
 The
 .Fl c
 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; see
 .Xr chflags 1
 for a list of possible flags and their meanings.
+.\" ==========
 .It Fl g
 Specify a group.
 A numeric GID is allowed.
+.\" ==========
 .It Fl M
 Disable all use of
 .Xr mmap 2 .
+.\" ==========
 .It Fl m
 Specify an alternate 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.
 A numeric UID is allowed.
+.\" ==========
 .It Fl p
 Preserve the modification time.
 Copy the file, as if the
@@ -136,10 +147,11 @@ Copy the file, as if the
 (compare and copy) option is specified,
 except if the target file doesn't already exist or is different,
 then preserve the modification time of the file.
+.\" ==========
 .It Fl S
 Safe copy.
 Normally,
-.Nm
+.Nm install
 unlinks an existing target before installing the new file.
 With the
 .Fl S
@@ -147,30 +159,32 @@ flag a temporary file is used and then renamed to be
 the target.
 The reason this is safer is that if the copy or
 rename fails, the existing target is left untouched.
+.\" ==========
 .It Fl s
-.Nm
+.Nm install
 exec's the command
 .Xr strip 1
 to strip binaries so that
-.Nm
+.Nm install
 can be portable over a large
 number of systems and binary types.
+.\" ==========
 .It Fl v
 Causes
-.Nm
+.Nm install
 to show when
 .Fl C
 actually installs something.
 .El
 .Pp
 By default,
-.Nm
+.Nm install
 preserves all file flags, with the exception of the
 .Dq nodump
 flag.
 .Pp
 The
-.Nm
+.Nm install
 utility attempts to prevent moving a file onto itself.
 .Pp
 Installing
@@ -178,7 +192,7 @@ Installing
 creates an empty file.
 .Sh DIAGNOSTICS
 The
-.Nm
+.Nm install
 utility exits 0 on success, and 1 otherwise.
 .Sh FILES
 .Bl -tag -width INS@XXXX -compact
@@ -201,7 +215,7 @@ are created in the target directory.
 .El
 .Sh COMPATIBILITY
 Historically
-.Nm
+.Nm install
 moved files by default.
 The default was changed to copy in
 .Fx 4.4 .
@@ -216,22 +230,22 @@ The default was changed to copy in
 .Xr chown 8
 .Sh HISTORY
 The
-.Nm
+.Nm install
 utility appeared in
 .Bx 4.2 .
 .Sh BUGS
 Temporary files may be left in the target directory if
-.Nm
+.Nm install
 exits abnormally.
 .Pp
 File flags cannot be set by
 .Xr fchflags 2
 over a NFS file system.  Other file systems do not have a concept of flags.
-.Nm
+.Nm install
 will only warn when flags could not be set on a file system
 that does not support them.
 .Pp
-.Nm
+.Nm install
 with
 .Fl v
 falsely says a file is copied when