From b24c54e8eeb64103c2c0bcdd3c5e478a79efcba9 Mon Sep 17 00:00:00 2001
From: Jim Meyering <jim@meyering.net>
Date: Tue, 11 Nov 2003 12:38:07 +0000
Subject: [PATCH] (chown invocation) [chownchgrpoptions]: New macro describing
 -H, -L, -P options.  Use it here. (chgrp invocation): And here.

---
 doc/coreutils.texi | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index d3160c099..539505311 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -7670,6 +7670,44 @@ Recursively change ownership of directories and their contents.
 
 @end table
 
+@macro chownchgrpoptions
+The following options modify how @command{chown} and @command{chgrp}
+traverse a hierarchy when the @option{--recursive} (@option{-R})
+option is also specified.
+If more than one is specified, only the final one takes effect.
+These options determine whether processing a symbolic link to a directory
+entails operating on just the symbolic link or on all files in the
+hierarchy rooted at that directory.
+Note that these options are independent of @option{--dereference} and
+@option{--no-dereference} (@option{-h}), which control whether to modify
+a symlink or its referent.
+
+@table @samp
+
+@item -H
+@opindex -H
+@cindex traverse symbolic links specified on the command line
+If @option{--recursive} (@option{-R}) is specified and
+a command line argument is a symbolic link to a directory, traverse it.
+
+@item -L
+@opindex -L
+@cindex traverse every symbolic link to a directory encountered
+In a recursive traversal, traverse every symbolic link to a directory
+that is encountered.
+
+@item -P
+@opindex -P
+@cindex do not traverse any symbolic links
+Do not traverse any symbolic links.
+This is the default if none of @option{-H}, @option{-L},
+or @option{-P} is specified.
+
+@end table
+@end macro
+
+@chownchgrpoptions
+
 
 @node chgrp invocation
 @section @command{chgrp}: Change group ownership
@@ -7754,6 +7792,8 @@ Recursively change the group ownership of directories and their contents.
 
 @end table
 
+@chownchgrpoptions
+
 
 @node chmod invocation
 @section @command{chmod}: Change access permissions
-- 
2.34.1