From: Paul Eggert <eggert@cs.ucla.edu>
Date: Sun, 26 Oct 2025 22:07:39 +0000 (-0700)
Subject: doc: mention empty symlink issues
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8d83c310319a03f52ba2f5dee768d41e767d890c;p=thirdparty%2Fgnulib.git

doc: mention empty symlink issues
---

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 @@ 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 c3199cdd98..7ec8dd5172 100644
--- 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