(split) LDP v3.24 -> v3.29 の定型的な変更内容を反映。

[linuxjm/LDP_man-pages.git] / draft / man3 / ftw.3

diff --git a/draft/man3/ftw.3 b/draft/man3/ftw.3
index 59af2f9..154fdad 100644 (file)
--- a/draft/man3/ftw.3
+++ b/draft/man3/ftw.3
@@ -40,7 +40,7 @@
 .\"
 .\" WORD:       file descriptor         ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¡¼
 .\"
-.TH FTW 3 2008-08-06 "Linux" "Linux Programmer's Manual"
+.TH FTW 3 2010-09-20 "Linux" "Linux Programmer's Manual"
 .\"O .SH NAME
 .SH ̾Á°
 .\"O ftw, nftw \- file tree walk
@@ -126,12 +126,29 @@ ftw, nftw \- 
 .IR fn ()
 ¤ò¸Æ¤Ó½Ð¤¹¡£
 .\"O .I fpath
-.\"O is the pathname of the entry relative to
-.\"O .IR dirpath .
+.\"O is the pathname of the entry,
+.\"O and is expressed either as a pathname relative to the calling process's
+.\"O current working directory at the time of the call to
+.\"O .BR ftw (),
+.\"O if
+.\"O .IR dirpath
+.\"O was expressed as a relative pathname,
+.\"O or as an absolute pathname, if
+.\"O .I dirpath
+.\"O was expressed as an absolute pathname.
 .I fpath
-¤Ï¥¨¥ó¥È¥ê¤Î
+¤Ï¥¨¥ó¥È¥ê¤Î¥Ñ¥¹Ì¾¤Ç¤¢¤ë¡£
 .I dirpath
-¤«¤é¤ÎÁêÂХѥ¹Ì¾¤Ç¤¢¤ë¡£
+¤¬ÁêÂХѥ¹Ì¾¤Ç»ØÄꤵ¤ì¤¿¾ì¹ç¤Ë¤Ï¡¢
+.I fpath
+¤Ï
+.BR ftw ()
+¤¬¸Æ¤Ó½Ð¤µ¤ì¤¿»þÅÀ¤Î¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î¥«¥ì¥ó¥È¥ï¡¼¥­¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê
+¤«¤é¤ÎÁêÂХѥ¹Ì¾¤È¤Ê¤ë¡£
+.I dirpath
+¤¬ÀäÂХѥ¹Ì¾¤Ç»ØÄꤵ¤ì¤¿¾ì¹ç¤Ë¤Ï¡¢
+.I fpath
+¤ÏÀäÂХѥ¹Ì¾¤È¤Ê¤ë¡£
 .\"O .I sb
 .\"O is a pointer to the
 .\"O .I stat
@@ -342,12 +359,17 @@ ftw, nftw \- 
 
 .\"O The feature test macro
 .\"O .B _GNU_SOURCE
-.\"O must be defined in order to
+.\"O must be defined
+.\"O (before including
+.\"O .I any
+.\"O header files)
+.\"O in order to
 .\"O obtain the definition of \fBFTW_ACTIONRETVAL\fP from \fI<ftw.h>\fP.
 .I <ftw.h>
 ¤Ç
 .B FTW_ACTIONRETVAL
-¤¬ÄêµÁ¤µ¤ì¤ë¤è¤¦¤Ë¤¹¤ë¤Ë¤Ï¡¢
+¤ÎÄêµÁ¤¬Í­¸ú¤Ë¤¹¤ë¤¿¤á¤Ë¤Ï¡¢
+(¡Ö¤É¤Î¡×¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¤ò¥¤¥ó¥¯¥ë¡¼¥É¤¹¤ë¤è¤ê¤âÁ°¤Ë)
 µ¡Ç½¸¡ºº¥Þ¥¯¥í
 .B _GNU_SOURCE
 ¤òÄêµÁ¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
@@ -563,6 +585,14 @@ POSIX.1-2008 
 ¤òÇÑ»ßͽÄê¤È¤·¤Æ¤¤¤ë¡£
 .\"O .SH NOTES
 .SH Ãí°Õ
+.\"O POSIX.1-2001 note that the results are unspecified if
+.\"O .I fn
+.\"O does not preserve the current working directory.
+POSIX.1-2001 ¤ÎÃíµ­¤Ë¤è¤ë¤È¡¢
+.I fn
+¤¬¥«¥ì¥ó¥È¥ï¡¼¥­¥ó¥°¥Ç¥£¥ì¥¯¥È¥ê¤òÊÝ»ý¤·¤Ê¤«¤Ã¤¿¾ì¹ç¤Î
+·ë²Ì¤Ïµ¬Äꤵ¤ì¤Æ¤¤¤Ê¤¤¤È¤µ¤ì¤Æ¤¤¤ë¡£
+.PP
 .\"O The function
 .\"O .BR nftw ()
 .\"O and the use of \fBFTW_SL\fP with