install.1: Grammar fixups

nstall(1): add support for -v

Reviewed by rillig@ and thorpej@, thanks!

Remove unnecessary Bk/Ek pairs from SYNOPSIS.
No effective change except where I used the opportunity to sort options
and/or option descriptions.

Fix whitespace nits. Suggested by Bug Hunting.

branches: 1.45.6;
Reorder sections to canonical order. Use .Ex -std.

Bump date for previous.

Add support for writing sha256, sha384, and sha512 digests to
a metalog. mtree(8) has supported these for a long time.

branches: 1.42.42;
Drop trailing space.

Implement -h {none,md5,rmd160,sha1} to determine the appropriate hash
(digest) when copying a file to store in the -M METALOG.

now that -c is the default, use "copy" instead of "move"

Make "copy the file" (the -c option) the default behaviour. The -c option
is kept for backwards compatibility but now has no effect.

Patch from Bruce Nourish in PR bin/23874, with some minor changes by me.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22365, verified by myself.

Use ; instead of , in a sentence (and fix case of next word).

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.

Add a missing word.

Implement '-D destdir'; if '-M metalog' is being used, remove a
leading `destdir' from the file name logged to the metalog.
The -D option has no effect on where the actual files are installed.

Drop trailing whitespace.

Add '-N dbdir', to specify that user & group lookups are to be done from
dbdir/master.passwd and dbdir/group, using simple text file parsing
routines from ../../usr.sbin/mtree/getid.c.

New sentence, new line.

- Add "-a afterinstallcommand", which runs "sh -c afterinstallcmd target"
after target has been installed and possibly stripped with -s, but
before ownership, permissions or timestamps are set, and before
renaming (with -r) occurs. Per discussion with simonb.
- When metalogging hardlinks, log the mode of the existing target
(rather than the default 0755), and ignore owner/group/fflags.
- Improve man page description of various options to include argument name.
- Clean up usage() to use getprogname(), etc.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Punctuation nit.

Whitespace cleanup.

Add '-T tags', to specify mtree(8) tags to be written out to the '-M metalog'
for the current entry. Concept suggested by Perry Metzger.

- Implement "-M log", which appends the metadata associated with the
installed file or directory to `log'. This is primarily designed
to be used in conjunction with -U, but that's not mandatory.
Provide metadata_log() to do the hard work. The log file is opened
for append at the start, and flock(LOCK_EX) is used to prevent
interleaved output (from multiple concurrent install(8) operations).
- Improve parsing of owner and groups (e.g., strtoul() instead of atoi()),
and don't rely upon uid==-1 to indicate "no owner"; use a flag instead.
- Make fileflags a global variable; uid, gid, and mode are, so lets be
consistent...
- Improve -U (unpriv); work on file flags as well, and only try to change
the file flags after the temporary file is renamed (since certain flags
will prevent the rename from working).

The -r flag is applicable to the file1 -> file2 case, too.

Change
"program used to trip installed binaries"
to
"program used to strip installed binaries"

For commands and utilities, use EXIT STATUS rather than RETURN VALUES or
DIAGNOSTICS as appropriate (and documented in mdoc(7)).

clean up documentation of STRIP envioronment var.

Make the STRIP env var a little more obvious in the documentation, and
clean up the bottom of this manpage just a tad.

Spell "privilege" correctly (correct spelling from Jonathan Stone).

Add `-U' flag (for "unprivileged"). Currently just skips the
chown/chgrp stages which would otherwise blow out if not running as
root. A future version may log the owner/group to allow correction by
a later privileged cleanup pass.

Just warn about madvise failure; it's not something to blow up about.

Document new option, and clean up option grouping for -d (install
directory) option.

More and more .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.

Clean up SYNOPSIS formatting.

PR/2936: Brian C. Grayson: Avoid truncating precious files when installing
and the filesystem is full. Added -r flag to install, which installs on
a temporary file and then renames to the final destination.

enable numbered backups via -B.old%02d

Add a -b(ackup) flag to move any existing file(s) aside by renaming
them to file.old instead of simply deleting them. A different backup
suffix may be chosen with the -B option's argument.

Add new option -S, which is like -s, but takes a string of options to pass to strip,
rather than "-s". For example:
install -S "-i -s symbolfile" foo /usr/bin/foo
Invokes:
/bin/sh -c "strip -i -s /usr/bin/foo"
This is needed, because we need different strip options for dynamic libraries and
Mach-O bundles than for executables; our strip supports more directed stripping.
/bin/sh is used in this case, to parse the arguments.

Don't bother mmap()ing files of zero length. Was a workaround for a bug in our mmap(),
which didn't get along with such files, but makes sense anyway.

add -p flag, similar to cp(1)

getopt returns -1 not EOF, fix .Nm

WARNSify; deprecate register; clean up .Nm

Allow the environment variable $STRIP to override _PATH_STRIP for
`-s', helping out cross-compiling.

PR/3445: NAKAJIMA Yoshihiro: Typo fix

Add support for installing hard and symbolic links via the [-l harms] flag.

alternate -> alternative, per PR 2643

Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id convention.
Changed to use err(),errx(),warn(),warnx().

Add RCS indentifiers.

Added -d option to install

branches: 1.1.1;
Initial revision