X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fposix-functions%2Flink.texi;h=d4f2a7e0b4da799fba00fe33f8123d4f5e6b3d58;hb=07809063056aef043ba738ab8229042f1ffc9659;hp=ace07cdeb6036755bd496f0d46b780517d8f03d3;hpb=d1ed8a817f5d07d4013cfa0988ee2da8b2937db6;p=gnulib.git

diff --git a/doc/posix-functions/link.texi b/doc/posix-functions/link.texi
index ace07cdeb..d4f2a7e0b 100644
--- a/doc/posix-functions/link.texi
+++ b/doc/posix-functions/link.texi
@@ -2,7 +2,7 @@
 @section @code{link}
 @findex link
 
-POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/link.html}
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/link.html}
 
 Gnulib module: link
 
@@ -11,8 +11,20 @@ Portability problems fixed by Gnulib:
 @item
 This function is missing on some platforms:
 mingw.
+@item
+This function fails to reject trailing slashes on non-directories on
+some platforms:
+FreeBSD 7.2, Solaris 11 2010-11, Cygwin 1.5.x.
+@item
+When the second argument is a dangling symlink, some platforms follow
+that link and create the destination rather than failing:
+IRIX 6.5.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+When the first argument is a symlink, some platforms create a
+hard-link to what the symlink referenced, rather than to the symlink
+itself.  Use @samp{linkat} to force a particular behavior.
 @end itemize