---
doc/posix-functions/symlink.texi | 6 ++++++
doc/posix-functions/symlinkat.texi | 6 ++++++
2 files changed, 12 insertions(+)
diff --git a/doc/posix-functions/symlink.texi b/doc/posix-functions/symlink.texi
index de4aae4beb..8007a5fa35 100644
--- a/doc/posix-functions/symlink.texi
+++ b/doc/posix-functions/symlink.texi
@@ -23,4 +23,10 @@ symlink
@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 c3199cdd98..7ec8dd5172 100644
--- a/doc/posix-functions/symlinkat.texi
+++ b/doc/posix-functions/symlinkat.texi
@@ -29,4 +29,10 @@ symlinkat
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
--
2.51.0
