@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 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.
@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