rename, renameat: Document Linux bug with NFS.

<http://lists.gnu.org/archive/html/bug-gnulib/2010-11/msg00154.html>.
* doc/posix-functions/rename.texi: Mention the NFS bug on Linux.
* doc/posix-functions/renameat.texi: Likewise.
Suggested by Eric Blake.

diff --git a/ChangeLog b/ChangeLog
index e2bd35cfaa9c2776d46175a1d15efd4117dfbd2f..5ea657c5435223b888d5236cf7465e2a64544a42 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2010-11-13  Bruno Haible  <bruno@clisp.org>
+
+       rename, renameat: Document Linux bug with NFS
+       <http://lists.gnu.org/archive/html/bug-gnulib/2010-11/msg00154.html>.
+       * doc/posix-functions/rename.texi: Mention the NFS bug on Linux.
+       * doc/posix-functions/renameat.texi: Likewise.
+       Suggested by Eric Blake.
+
 2010-11-13  Bruno Haible  <bruno@clisp.org>
 
        rename test: Add comments.

diff --git a/doc/posix-functions/rename.texi b/doc/posix-functions/rename.texi
index 7c66d28766fe1bb977e6b2b6eb3a17a912bb6c34..40e7c3c811d31699072c21a265d4d1dde2fbb0ea 100644 (file)
--- a/doc/posix-functions/rename.texi
+++ b/doc/posix-functions/rename.texi
@@ -60,6 +60,11 @@ is counter-intuitive, so on some systems, @code{rename} fails with
 @code{ENOTDIR} if either argument is a symlink with a trailing slash:
 glibc, OpenBSD, Cygwin 1.7.
 @item
+After renaming a non-empty directory over an existing empty directory,
+the old directory name is still visible through the @code{stat} function
+for 30 seconds after the rename, on NFS file systems, on some platforms:
+Linux 2.6.18.
+@item
 This function will not rename a source that is currently opened
 by any process:
 mingw.

diff --git a/doc/posix-functions/renameat.texi b/doc/posix-functions/renameat.texi
index 6100fb1c1f503f2c081aa92bdcfb172f19cab76c..e855a9327a642d65a8789270ea3a48f9144c219c 100644 (file)
--- a/doc/posix-functions/renameat.texi
+++ b/doc/posix-functions/renameat.texi
@@ -39,6 +39,11 @@ is counter-intuitive, so on some systems, @code{renameat} fails with
 @code{ENOTDIR} if either argument is a symlink with a trailing slash:
 glibc, OpenBSD, Cygwin 1.7.
 @item
+After renaming a non-empty directory over an existing empty directory,
+the old directory name is still visible through the @code{stat} function
+for 30 seconds after the rename, on NFS file systems, on some platforms:
+Linux 2.6.18.
+@item
 This function will not rename a source that is currently opened
 by any process:
 mingw.