fts.3: Improve description of physical vs. logical tree walking

See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=633505

Reported-by: James Youngman <jay@gnu.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Simon Paillard 2012-10-25 12:33:53 +02:00 committed by Michael Kerrisk
parent 47cfbecf0a
commit 86be5cf6f9
1 changed files with 5 additions and 3 deletions

View File

@ -35,7 +35,7 @@
.\"
.\" 2007-12-08, mtk, Converted from mdoc to man macros
.\"
.TH FTS 3 2007-12-28 "Linux" "Linux Programmer's Manual"
.TH FTS 3 2012-10-25 "Linux" "Linux Programmer's Manual"
.SH NAME
fts, fts_open, fts_read, fts_children, fts_set, fts_close \- \
traverse a file hierarchy
@ -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