More correction of section 3 layout. directory->opendir, fts->fts_open,
getcap->cgetent. pwcache->user_from_uid. And then repair references.
ok jmc

markup flag arguments; ok jmc@ schwarze@

use .Fl macro for command line options

Document the -h option for chmod and chflags, rewording the chgrp(1) and
chown(8) manpages to be consistent and clearer about it as well.

Correct the handling of symbolic links by chmod/chgrp/chown/chflags,
making them more resistant to TOCTOU race conditions too.

ok tobias@

consistency fixes, to match the other ch* utils;
ok millert sobrado

add an EXIT STATUS section for /bin;

- arch is superuser-only
- opaque is gone
with/ok tedu@, millert@

sort list of flags.

convert to new .Dd format;

shuffle the text somewhat to make the page read better;
use .Ex;

document the "opaque", "arch", and "nodump" flags more fully;
closes documentation/5384 from Andrew Hamilton-Wright

help from henning, otto, and weingart

simplify the .Ar file ... line;

- put description of -R in the correct place
- ellipsis implies optional args; no need for .Op

remove confusing sentence which suggests we usually run in single-user
mode; instead correctly reference securelevel(7);

based on a diff from han boetes;
ok millert@

- remove unnecessary -compact in a display
- use .Dl for a one-line display, not .Bd
- simplify SYNOPSIS

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.

Insert some missing commas.

merge chflags(1) into chmod.
also, use new strtofflags, avoid ls/stat_flags.c usage.
millert@ ok