Bug#877448: [PATCH] mention what will cause link to fail

[積丹尼 Dan Jacobson]

Package: perl-doc
Version: 5.26.0-8
Severity: wishlist
File: /usr/share/perl/5.26.0/pod/perlfunc.pod

--- /usr/share/perl/5.26.0/pod/perlfunc.pod	2017-09-12 23:07:07.000000000 +0800
+++ /tmp/perlfunc.pod	2017-10-02 03:29:33.594285599 +0800
@@ -3889,6 +3889,8 @@
 Creates a new filename linked to the old filename.  Returns true for
 success, false otherwise.
 
+Uses the link system call, which see for reasons for failure. See unlink below for method to print failed filenames.
+
 Portability issues: L<perlport/link>.
 
 =item listen SOCKET,QUEUESIZE