@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
@item
This function fails to reject trailing slashes on non-directories on
some platforms:
-Solaris, Cygwin 1.5.x.
+FreeBSD 7.2, Solaris 11 2010-11, Cygwin 1.5.x.
@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