readlink: document portability issue with symlink length

[pspp] / doc / posix-functions / lstat.texi

diff --git a/doc/posix-functions/lstat.texi b/doc/posix-functions/lstat.texi
index dbe31f8636b89a721a4c8c72f6695aa650454ee4..328b896c9004edd373620c46a33910fd9c8294f5 100644 (file)
--- a/doc/posix-functions/lstat.texi
+++ b/doc/posix-functions/lstat.texi
@@ -35,4 +35,8 @@ portably replace @code{stat} via an object-like macro.  Therefore,
 expressions such as @code{(islnk ? lstat : stat) (name, buf)} are not
 portable, and should instead be written @code{islnk ? lstat (name,
 buf) : stat (name, buf)}.
+@item
+On some filesystems, @code{st_size} contains bogus information for
+symlinks; use the gnulib module areadlink-with-size for a better way
+to get symlink contents.
 @end itemize