diff --git a/usr.sbin/chown/chown.8 b/usr.sbin/chown/chown.8 index 1add3daf65be..364ac883f050 100644 --- a/usr.sbin/chown/chown.8 +++ b/usr.sbin/chown/chown.8 @@ -80,8 +80,12 @@ If the option is specified, no symbolic links are followed. This is the default. .It Fl R -Change the user ID and/or the group ID for the file hierarchies rooted -in the files instead of just the files themselves. +Change the user ID and/or the group ID of the specified directory trees +(recursively, including their contents) and files. +Beware of unintentionally matching the +.Dq Pa ".." +hard link to the parent directory when using wildcards like +.Dq Li ".*" . .It Fl f Don't report any failure to change file owner or group, nor modify the exit status to reflect such failures.