sbase/xinstall.1
Michael Forney 22921a859f Fix various lint warnings in manuals
Fix "new sentence, new line" warnings throughout so that formatters
can produce correct spacing between sentences.

join.1
  Remove unnecessary Ns macros. These are not necessary for delimeters,
  which get special treatment.

xinstall.1
  Fix date in manual. The contents were last modified on 2016-12-03,
  so use that instead of the invalid date.

grep.1
  Fix escape sequence for `\<` and `\>`.

ed.1
  Remove spurious `\\n` escape for the null-command.
2020-03-01 15:32:11 -08:00

87 lines
1.5 KiB
Groff

.Dd 2016-12-03
.Dt INSTALL 1
.Os sbase
.Sh NAME
.Nm install
.Nd copy files and set attributes
.Sh SYNOPSIS
.Nm
.Op Fl g Ar group
.Op Fl o Ar owner
.Op Fl m Ar mode
.Po
.Fl d Ar dir ...
|
.Op Fl D
.Po
.Fl t Ar dest
.Ar source ...
|
.Ar source ...
.Ar dest
.Pc
.Pc
.Sh DESCRIPTION
.Nm
copies
.Ar source
to
.Ar dest .
If more than one
.Ar source
is given
.Ar dest
is treated as a directory.
Otherwise
.Ar dest
is treated as a filename.
.Nm
can also change the attributes of the copies.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl d
Create the directories
.Ar dir .
.It Fl D
Create missing parent directories to
.Ar dest .
If
.Ar dest
is to be treated as a directory, it is created too if missing.
.It Fl g Ar group
Change the installed files' group to
.Ar group .
This may be a group name or a group identifier.
.It Fl m Ar mode
Change the file modes.
Both numerical and symbolic values are supported.
See
.Xr chmod 1
for the syntex.
Default mode 0755.
If a file has the mode 0644 and is copied with
.It Fl o Ar owner
Change the installed files' owner to
.Ar owner .
This may be a user name or a user identifier.
.It Fl t Ar dest
Copy files into the directory
.Ar dest .
.Nm install ,
the copy's mode will be 0755 unless
.Fl m
is used to select another mode.
When the symbolic notation is used, the base mode is 0000.
.El
.Sh SEE ALSO
.Xr chmod 1 ,
.Xr chown 1 ,
.Xr cp 1 ,
.Xr mkdir 1
.Sh STANDARDS
The
.Nm
utility is not standardized.
This implementation is a subset of the GNU implementation and a subset
with extensions to the FreeBSD implementation.