1 files changed, 18 insertions, 0 deletions

diff --git a/bin/ln/symlink.7 b/bin/ln/symlink.7
index 1ec95c81216d..a0820fe627fb 100644
--- a/bin/ln/symlink.7
+++ b/bin/ln/symlink.7
@@ -160,6 +160,24 @@ is included in this rule, while the command
 is not.
 (The latter is described in the third area, below.)
 .Pp
+If it is explicitly intended that the command operate on the symbolic
+link instead of following the symbolic link, e.g., it is desired that
+.Dq Li "chown slink"
+change the ownership of the file that
+.Dq Li slink
+is, whether it is a symbolic link or not, the
+.Fl h
+option should be used.
+In the above example,
+.Dq Li "chown root slink"
+would change the ownership of the file referenced by
+.Dq Li slink ,
+while
+.Dq Li "chown -h root slink"
+would change the ownership of
+.Dq Li slink
+itself.
+.Pp
 There are four exceptions to this rule.
 The
 .Xr mv 1