23788: add -h option to chown symlinks rather than targets, and change default behavior to do the opposite.

1 files changed, 5 insertions, 2 deletions

diff --git a/Doc/Zsh/mod_files.yo b/Doc/Zsh/mod_files.yo
index db45923c7..2bc83b5db 100644
--- a/Doc/Zsh/mod_files.yo
+++ b/Doc/Zsh/mod_files.yo
@@ -6,12 +6,12 @@ The tt(zsh/files) module makes some standard commands available as builtins:
 
 startitem()
 findex(chgrp)
-item(tt(chgrp) [ tt(-Rs) ] var(group) var(filename) ...)(
+item(tt(chgrp) [ tt(-hRs) ] var(group) var(filename) ...)(
 Changes group of files specified.  This is equivalent to tt(chown) with
 a var(user-spec) argument of `tt(:)var(group)'.
 )
 findex(chown)
-item(tt(chown) [ tt(-Rs) ] var(user-spec) var(filename) ...)(
+item(tt(chown) [ tt(-hRs) ] var(user-spec) var(filename) ...)(
 Changes ownership and group of files specified.
 
 The var(user-spec) can be in four forms:
@@ -33,6 +33,9 @@ Each of var(user) and var(group) may be either a username (or group name, as
 appropriate) or a decimal user ID (group ID).  Interpretation as a name
 takes precedence, if there is an all-numeric username (or group name).
 
+If the target is a symbolic link, the tt(-h) option causes tt(chown) to set
+the ownership of the link instead of its target.
+
 The tt(-R) option causes tt(chown) to recursively descend into directories,
 changing the ownership of all files in the directory after
 changing the ownership of the directory itself.