Re: Bug#633505: manpages-dev: fts(3) has inaccurate description of physical vs. logical

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



forwarded 633505 linux-man@xxxxxxxxxxxxxxx
thanks

Hi,

On Sun, Jul 10, 2011 at 10:30:43PM +0100, James Youngman wrote:
> Package: manpages-dev
> Version: 3.27-1
> Severity: minor
> 
> 
> The descriptions of the effects of FTS_LOGICAL and FTS_PHISICAL in the
> subsection entitled fts_open() are correct.  But the DESCRIPTION
> section is incorrect.  It says:
> 
>   It is possible to walk the hierarchy "logically" (ignoring symbolic
>   links) or physically (visiting symbolic links), order the walk of
>   the hierarchy or prune and/or revisit portions of the hierarchy.
> 
> This is not accurate.  Symbolic links are never ignored.  Here is a
> clearer description:
> 
>   It is possible to walk the hierarchy "logically" (visiting the files
>   that symbolic links point to, like "find -L") or "physically"
>   (visiting the symbolic links themselves instead, like "find -P") ,
>   order the walk of the hierarchy or prune and/or revisit portions of
>   the hierarchy.
 
Thanks for the report James, confirmed by test, patch a bit modified and
forwarded upstream.

-- 
Simon Paillard
diff --git a/man3/fts.3 b/man3/fts.3
index 1c49155..6eedd4e 100644
--- a/man3/fts.3
+++ b/man3/fts.3
@@ -77,8 +77,10 @@ In general, directories are visited two distinguishable times; in preorder
 (before any of their descendants are visited) and in postorder (after all
 of their descendants have been visited).
 Files are visited once.
-It is possible to walk the hierarchy "logically" (ignoring symbolic links)
-or physically (visiting symbolic links), order the walk of the hierarchy or
+It is possible to walk the hierarchy "logically" (visiting the files that
+symbolic links point to)
+or physically (visiting the symbolic links themselves), order the walk of the
+hierarchy or
 prune and/or revisit portions of the hierarchy.
 .PP
 Two structures are defined (and typedef'd) in the include file

[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux