doc: tweak *at function documentation

* doc/posix-functions/faccessat.texi (faccessat): Mention
known issue with replacement.
* doc/posix-functions/fchdir.texi (fchdir): Likewise.
* doc/posix-functions/linkat.texi (linkat): Likewise.
* doc/posix-functions/mkfifoat.texi (mkfifoat): Likewise.
* doc/posix-functions/mknodat.texi (mknodat): Likewise.
* doc/posix-functions/readlinkat.texi (readlinkat): Likewise.
* doc/posix-functions/renameat.texi (renameat): Likewise.
* doc/posix-functions/symlinkat.texi (symlinkat): Likewise.

Signed-off-by: Eric Blake <ebb9@byu.net>

diff --git a/ChangeLog b/ChangeLog
index 05a47306710aaf1ebadde95f04fc77d50e08b528..cc4b51d3fd5ea40a3eb9b947fcbcefa6fac9c108 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,16 @@
 2009-10-06  Eric Blake  <ebb9@byu.net>
 
+       doc: tweak *at function documentation
+       * doc/posix-functions/faccessat.texi (faccessat): Mention
+       known issue with replacement.
+       * doc/posix-functions/fchdir.texi (fchdir): Likewise.
+       * doc/posix-functions/linkat.texi (linkat): Likewise.
+       * doc/posix-functions/mkfifoat.texi (mkfifoat): Likewise.
+       * doc/posix-functions/mknodat.texi (mknodat): Likewise.
+       * doc/posix-functions/readlinkat.texi (readlinkat): Likewise.
+       * doc/posix-functions/renameat.texi (renameat): Likewise.
+       * doc/posix-functions/symlinkat.texi (symlinkat): Likewise.
+
        openat: fix GNU/Hurd bug in unlinkat
        * m4/openat.m4 (gl_FUNC_OPENAT): Replace unlinkat if unlink is
        broken.

diff --git a/doc/posix-functions/faccessat.texi b/doc/posix-functions/faccessat.texi
index 835a5d8db0138c1d494dd7e342a19c6c567b1582..f1d7be096e3bd18515d26434fe91c09a9eca880c 100644 (file)
--- a/doc/posix-functions/faccessat.texi
+++ b/doc/posix-functions/faccessat.texi
@@ -13,7 +13,8 @@ This function is missing on some platforms:
 glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX
 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw,
 Interix 3.5, BeOS.
-However, the replacement does not always take into account ACLs.
+However, the replacement does not always take into account ACLs.  Also,
+it is not safe to be used in libraries and is not multithread-safe.
 @end itemize
 
 Portability problems not fixed by Gnulib:

diff --git a/doc/posix-functions/fchdir.texi b/doc/posix-functions/fchdir.texi
index 5283b6cce10194ed08ab930bda3085ed45989b41..06e99d812505d2220b4660bde4b7c344c77ac306 100644 (file)
--- a/doc/posix-functions/fchdir.texi
+++ b/doc/posix-functions/fchdir.texi
@@ -11,6 +11,7 @@ Portability problems fixed by Gnulib:
 @item
 This function is missing on some platforms:
 Tandem/NSK, mingw, BeOS.
+But the replacement function is not safe to be used in libraries and is not multithread-safe.
 @end itemize
 
 Portability problems not fixed by Gnulib:

diff --git a/doc/posix-functions/linkat.texi b/doc/posix-functions/linkat.texi
index 62fc43dc339041619b1630e8d8ddf77f674d04b7..1fe5434e92e8d8cb230caa1055c9f75c189fa2b2 100644 (file)
--- a/doc/posix-functions/linkat.texi
+++ b/doc/posix-functions/linkat.texi
@@ -12,6 +12,7 @@ Portability problems fixed by Gnulib:
 This function is missing on some platforms:
 glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX
 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS.
+But the replacement function is not safe to be used in libraries and is not multithread-safe.
 @end itemize
 
 Portability problems not fixed by Gnulib:

diff --git a/doc/posix-functions/mkfifoat.texi b/doc/posix-functions/mkfifoat.texi
index c3e39cadef191279bb588b1f72401ce69f35c3ec..2cd9f6f130fb7854993db6b0a1beebf316497206 100644 (file)
--- a/doc/posix-functions/mkfifoat.texi
+++ b/doc/posix-functions/mkfifoat.texi
@@ -13,6 +13,7 @@ This function is missing on some platforms:
 glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX
 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw,
 Interix 3.5, BeOS.
+But the replacement function is not safe to be used in libraries and is not multithread-safe.
 @end itemize
 
 Portability problems not fixed by Gnulib:

diff --git a/doc/posix-functions/mknodat.texi b/doc/posix-functions/mknodat.texi
index d1af058612032a431bd8502f806c2dd76e14c75b..6a6ed3fdaa7591cdd1a06a99e0aac97c4cc7b6ca 100644 (file)
--- a/doc/posix-functions/mknodat.texi
+++ b/doc/posix-functions/mknodat.texi
@@ -13,6 +13,7 @@ This function is missing on some platforms:
 glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX
 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw,
 Interix 3.5, BeOS.
+But the replacement function is not safe to be used in libraries and is not multithread-safe.
 @end itemize
 
 Portability problems not fixed by Gnulib:

diff --git a/doc/posix-functions/readlinkat.texi b/doc/posix-functions/readlinkat.texi
index 65f088fa594686de3accc47821909af74150e372..4cef74368103d5433931f21cbd418036b262c0a4 100644 (file)
--- a/doc/posix-functions/readlinkat.texi
+++ b/doc/posix-functions/readlinkat.texi
@@ -12,6 +12,7 @@ Portability problems fixed by Gnulib:
 This function is missing on some platforms:
 glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX
 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS.
+But the replacement function is not safe to be used in libraries and is not multithread-safe.
 @end itemize
 
 Portability problems not fixed by Gnulib:

diff --git a/doc/posix-functions/renameat.texi b/doc/posix-functions/renameat.texi
index 52f3921a667c12d2404000102968221017d7df06..ff08b09b279d9dc798b4976c8a2ac5f115ad0597 100644 (file)
--- a/doc/posix-functions/renameat.texi
+++ b/doc/posix-functions/renameat.texi
@@ -21,6 +21,7 @@ This function is missing on some platforms:
 glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX
 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 8, Cygwin 1.5.x, mingw,
 Interix 3.5, BeOS.
+But the replacement function is not safe to be used in libraries and is not multithread-safe.
 @end itemize
 
 Portability problems not fixed by Gnulib:

diff --git a/doc/posix-functions/symlinkat.texi b/doc/posix-functions/symlinkat.texi
index 7dd3887193dde6aa0cc45a1093a4d7e173651af0..d5ef9dca850b7cfb9393a3dd696691438c29476f 100644 (file)
--- a/doc/posix-functions/symlinkat.texi
+++ b/doc/posix-functions/symlinkat.texi
@@ -12,6 +12,7 @@ Portability problems fixed by Gnulib:
 This function is missing on some platforms:
 glibc 2.3.6, MacOS X 10.3, FreeBSD 6.0, NetBSD 3.0, OpenBSD 3.8, AIX
 5.1, HP-UX 11, IRIX 6.5, OSF/1 5.1, Solaris 10, Cygwin 1.5.x, mingw, Interix 3.5, BeOS.
+But the replacement function is not safe to be used in libraries and is not multithread-safe.
 @end itemize
 
 Portability problems not fixed by Gnulib: