From: Jim Meyering <jim@meyering.net>
Date: Mon, 27 Jan 2003 15:00:22 +0000 (+0000)
Subject: (FTW_DCH, FTW_DCHP): Better comments.
X-Git-Tag: COREUTILS-4_5_5~66
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=96332f0a7e1c70ef0a4bfe6497d3ebf225118aac;p=platform%2Fupstream%2Fcoreutils.git

(FTW_DCH, FTW_DCHP): Better comments.
---

diff --git a/lib/ftw_.h b/lib/ftw_.h
index 9cabf85..cdb3ed6 100644
--- a/lib/ftw_.h
+++ b/lib/ftw_.h
@@ -60,9 +60,17 @@ enum
 # define FTW_DNR	 FTW_DNR
   FTW_NS,		/* Unstatable file.  */
 # define FTW_NS	 FTW_NS
-  FTW_DCH,		/* Can't chdir to named directory.  */
+
+  /* Can't chdir to named directory.  This can happen only when using
+     FTW_CHDIR.  Note that although we can't chdir into that directory,
+     we were able to stat it, so SB (2nd argument to callback) is valid.  */
+  FTW_DCH,
 # define FTW_DCH FTW_DCH
-  FTW_DCHP,		/* Can't chdir to parent of named directory.  */
+
+  /* Can't chdir to parent of named directory.  This can happen only when
+     using FTW_CHDIR.  Unlike for FTW_DCH, in this case, SB is not valid.
+     In fact, it is NULL.  */
+  FTW_DCHP,
 # define FTW_DCHP FTW_DCHP
 
 # if defined __USE_BSD || defined __USE_XOPEN_EXTENDED