doc: mention empty symlink issues

diff --git a/doc/posix-functions/symlink.texi b/doc/posix-functions/symlink.texi
index de4aae4beb8280e7975bef4890ed26a1e00c99b6..8007a5fa354cf4d2a0a533f6e31ad91b07bb3e24 100644 (file)
--- a/doc/posix-functions/symlink.texi
+++ b/doc/posix-functions/symlink.texi
@@ -23,4 +23,10 @@ Portability problems not fixed by Gnulib:
 @itemize
 @item
 Some file systems do not support symbolic links.
+@item
+If the target is the empty string, this function can create an empty
+symbolic link instead of failing with @code{ENOENT} as GNU/Linux does:
+FreeBSD 14.0, NetBSD 10.0, OpenBSD 7.8, Solaris 11.4.
+On Solaris, the empty symbolic link @code{""} resolves like @code{"."} does;
+on the other operating systems, resolution fails with @code{ENOENT}.
 @end itemize

diff --git a/doc/posix-functions/symlinkat.texi b/doc/posix-functions/symlinkat.texi
index c3199cdd98c08f9b4af6a229c8d4f663125ed7bd..7ec8dd5172ddc8762657b497c5a19ae78d2a7f04 100644 (file)
--- a/doc/posix-functions/symlinkat.texi
+++ b/doc/posix-functions/symlinkat.texi
@@ -29,4 +29,10 @@ Portability problems not fixed by Gnulib:
 This function always fails with @code{ENOSYS} on platforms that don't
 support symlinks:
 mingw, MSVC 14.
+@item
+If the target is the empty string, this function can create an empty
+symbolic link instead of failing with @code{ENOENT} as GNU/Linux does:
+FreeBSD 14.0, NetBSD 10.0, OpenBSD 7.8, Solaris 11.4.
+On Solaris, the empty symbolic link @code{""} resolves like @code{"."} does;
+on the BSDs, resolution fails with @code{ENOENT}.
 @end itemize