summaryrefslogtreecommitdiff
path: root/gnulib/doc/posix-functions/rmdir.texi
diff options
context:
space:
mode:
Diffstat (limited to 'gnulib/doc/posix-functions/rmdir.texi')
m---------gnulib0
-rw-r--r--gnulib/doc/posix-functions/rmdir.texi35
2 files changed, 35 insertions, 0 deletions
diff --git a/gnulib b/gnulib
deleted file mode 160000
-Subproject 443bc5ffcf7429e557f4a371b0661abe98ddbc1
diff --git a/gnulib/doc/posix-functions/rmdir.texi b/gnulib/doc/posix-functions/rmdir.texi
new file mode 100644
index 0000000..4676d18
--- /dev/null
+++ b/gnulib/doc/posix-functions/rmdir.texi
@@ -0,0 +1,35 @@
+@node rmdir
+@section @code{rmdir}
+@findex rmdir
+
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/rmdir.html}
+
+Gnulib module: rmdir
+
+Portability problems fixed by Gnulib:
+@itemize
+@item
+This function is declared in different header files (namely, @code{<io.h>} or
+@code{<direct.h>}) on some platforms:
+mingw, MSVC 9.
+@item
+This function mistakenly removes a directory with
+@code{rmdir("dir/./")} on some platforms:
+Cygwin 1.5.x.
+@item
+This function fails with @code{EINVAL} instead of the expected
+@code{ENOTDIR} for @code{rmdir("file/")} on some platforms:
+mingw, MSVC 9.
+@end itemize
+
+Portability problems not fixed by Gnulib:
+@itemize
+@item
+When @code{rmdir} fails because the specified directory is not empty, the
+@code{errno} value is system dependent.
+@item
+POSIX requires that @code{rmdir("link-to-empty/")} remove @file{empty}
+and leave @file{link-to-empty} as a dangling symlink. This is
+counter-intuitive, so some systems fail with @code{ENOTDIR} instead:
+glibc
+@end itemize