autoupdate
[gnulib.git] / doc / posix-functions / rename.texi
index be997aa..300970c 100644 (file)
@@ -2,7 +2,7 @@
 @section @code{rename}
 @findex rename
 
-POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/rename.html}
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/rename.html}
 
 Gnulib module: rename
 
@@ -13,9 +13,14 @@ This function does not allow trailing slashes when creating a
 destination directory, as in @code{rename("dir","new/")}:
 NetBSD 1.6.
 @item
-This function does not reject trailing slashes on non-directories on
-some platforms, as in @code{rename("file","new/")}:
-Solaris 10, Cygwin 1.5.x, mingw.
+This function does not reject trailing slashes on the destination for
+non-directories on some platforms, as in @code{rename("file","new/")}:
+AIX 7.1, Solaris 11 2010-11, Cygwin 1.5.x, mingw.
+@item
+This function does not reject trailing slashes on symlinks to
+non-directories on some platforms, as in
+@code{rename("link-to-file/","f")}:
+FreeBSD 7.2.
 @item
 This function ignores trailing slashes on symlinks on some platforms,
 such that @code{rename("link/","new")} corrupts @file{link}:
@@ -55,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.